最近更新的页面
区块类型的更新传播
本资源旨在为需要在主题模板、模式或整个站点的区块中更新内容的人员提供指导。由于每种内容类型允许或禁止特定类型的同步,因此在创建前了解可能的情况对于简化未来的维护工作至关重要。 更新管理建议 尽早...
插件侧边栏
概述 如何为您的插件添加侧边栏。侧边栏是编辑器最右侧的区域。您的插件可以在 InspectorControls(齿轮图标)旁添加一个额外的图标,该图标可展开显示。 注意:本教程介绍自定义侧边栏,...
元数据框
概述 在区块编辑器出现之前,自定义元数据框被用于扩展编辑器功能。如今已有新的扩展方式,为开发者提供更强大的能力,并为内容创作者带来更优体验。建议将旧版自定义元数据框迁移至这些新方法之一,从而为编...
国际化
什么是国际化? 国际化是为软件提供多语言支持的过程,在本文语境中特指 WordPress。国际化常被缩写为 i18n,其中 18 代表首字母 i 与末字母 n 之间的字符数。 为您的插件和主题提...
格式工具栏 API
概述 格式 API 使开发者能够向格式工具栏添加自定义按钮,并让这些按钮对文本选区应用_格式_。加粗就是格式工具栏中标准按钮的一个例子。 在 WordPress 术语中,_格式_是一种具有文本级...
功能开关
"功能开关"是变量,允许您阻止 Gutenberg 项目中的特定代码发布到 WordPress 核心,并仅在插件中运行某些实验性功能。 介绍 globalThis.IS_GUTENBERG_P...
在编辑器中加载资源
本指南旨在成为在编辑器中加载资源(脚本和样式)的权威参考。此处概述的方法代表了推荐实践,但请注意,随着 WordPress 的发展,本资源也会不断更新。我们鼓励您持续关注更新。 自 WordPr...
无障碍访问
为 Gutenberg 项目开发者提供的无障碍访问文档。 有关无障碍访问和 WordPress 的更多信息,请参阅 Make WordPress 无障碍访问手册 和 无障碍访问团队部分。 地标区...
区块的静态或动态渲染
区块的前端标记可以在请求时由服务器端动态生成(动态区块),也可以在区块编辑器的保存过程中静态生成(静态区块)。本文将探讨这两种方法。 文章 静态区块与动态区块:有何区别? 对此主题提供了很好的介...
区块注册
WordPress 中的区块通常以插件形式打包,并使用 block.json 元数据在服务器端和客户端进行注册。 虽然可以仅在客户端注册区块,但最佳实践强烈建议同时在服务器端和客户端进行注册。...
区块的标记表示
区块在数据库或 HTML 模板中使用一种独特的基于 HTML 的语法存储,通过作为清晰区块分隔符的 HTML 注释来区分。这确保了区块标记在技术上是有效的 HTML。 以下是定义区块标记的一些准...
为区块编辑器使用 JavaScript
为区块编辑器开发区块通常涉及使用现代 JavaScript(ESNext 和 JSX),区块编辑器手册中的大多数示例都采用这些语法编写。 然而,这种形式的 JavaScript 必须转换为浏览器...
区块的文件结构
为 WordPress 开发自定义区块时,最佳实践是在插件中注册它们,而非主题中。此策略确保即使用户切换主题,您的区块仍可访问。虽然在某些情况下将区块直接嵌入主题可能合适,但本指南重点介绍插件中...
区块包装器
区块编辑器中的每个区块都包含在一个 HTML 包装器内,该包装器必须具备特定属性才能在编辑器和前端正常运行。作为开发者,我们可以直接操作此标记,WordPress 提供了诸如 useBlock...
block.json
block.json 文件通过使用相同的 JSON 格式块定义,在服务器端和客户端(区块编辑器)注册区块,从而简化了定义和注册区块的过程。 下图详细说明了 block.json 文件的基本结构...
编辑器中的区块
区块编辑器是一个 React 单页应用程序(SPA)。编辑器中的每个区块都是通过一个 React 组件显示的,该组件定义在用于在客户端注册区块的设置对象的 edit 属性中。 区块的 Edi...
Node.js 开发环境
为区块编辑器进行开发时,你将需要 Node.js 开发工具,以及一个代码编辑器和本地 WordPress 环境(参见区块开发环境)。Node.js ( node) 是一个开源运行时环境,允许你从...
开始使用 wp-scripts
@wordpress/scripts 包,通常被称为 wp-scripts,是一组配置文件和脚本,主要旨在标准化和简化需要 JavaScript 构建步骤的 WordPress 项目的开发流程...
开始使用 wp-env
@wordpress/env 包( wp-env)让你能够为构建和测试插件及主题,设置一个本地 WordPress 环境(站点),无需任何额外配置。 在遵循本指南之前,如果你尚未安装 Node....
开始使用 create-block
WordPress 区块编辑器中的自定义区块通常通过插件注册,并由一组特定文件定义。 @wordpress/create-block 包是一个官方支持的工具,用于搭建创建和注册区块所需的文件结构...