欢迎使用区块编辑器手册。
区块编辑器是用于构建和发布 WordPress 站点的现代范式。它使用区块的模块化系统来组合和格式化内容,旨在为网站和数字产品创建丰富且灵活的布局。
区块编辑器由以下几个主要元素组成,如下图所示:

高亮显示的元素包括:
- 插入器:用于将区块插入内容画布的面板
- 内容画布:内容编辑器,其中包含使用区块创建的内容
- 设置面板:用于配置选中区块的设置或文章设置的 panels
通过区块编辑器,您可以使用区块以模块化方式创建内容。WordPress 默认提供许多区块,您也可以创建自己的区块。
区块是离散的元素,例如段落、标题、媒体或嵌入。每个区块都作为单独的单元处理,具有独立的编辑和格式控制功能。当所有这些组件组合在一起时,它们构成了页面或文章的内容,随后存储在 WordPress 数据库中。
区块编辑器是
除了通过可视化的内容创作工具提供增强的编辑体验外,区块编辑器还是一个强大的开发者平台,拥有丰富的 API 功能集,允许以无数种方式对其进行操作和扩展。
浏览本手册
本手册专注于区块开发,并分为五个主要部分。
- 入门指南: 对于刚开始进行区块开发的人员,您可以在这里设置开发环境并学习区块开发的基础知识。其快速入门指南和教程:构建您的第一个区块是学习区块开发的绝佳起点。
操作指南: 在这里,您可以基于入门指南中学到的内容,学习如何解决特定问题。您还将找到可重用于自己项目的教程和示例代码,例如处理 WordPress 数据或策展编辑器体验。
参考指南: 本节是手册的核心,您可以在这里深入了解细节并查阅正在使用或需要信息的特定 API 的详细信息。除此之外,区块 API 参考涵盖了您想要对区块执行的大部分操作,并且每个组件和包也在此处进行了文档说明。组件也通过 Storybook 进行文档说明。
贡献者指南: Gutenberg 是开源软件,欢迎所有人参与项目贡献。本节详细介绍了如何贡献,无论是通过代码、设计、文档还是其他方式。
其他资源
本手册应被视为所有与区块开发相关的内容的权威资源。然而,还有其他资源可以帮助您。
- WordPress 开发者博客: 这是一个不断增长的技术文章资源库,涵盖与区块开发相关的特定主题和多种用例。该博客也是了解 WordPress 最新发展的绝佳方式。
- 学习 WordPress: 这是 WordPress 的学习资源枢纽,您可以在这里找到课程,例如区块开发入门:构建您的第一个自定义区块、将短代码转换为区块或使用 WordPress 数据层。
- WordPress.tv: 这是一个由 WordPress 社区策划和主持的与 WordPress 相关的视频枢纽(从 WordCamps 上的演讲到在线研讨会的录像)。您肯定能在这里找到有助于学习区块开发或区块编辑器的内容。
- Gutenberg 仓库: 区块编辑器的开发在 GitHub 上进行。该仓库包含有趣包的代码,例如
block-library(核心区块)或components(通用 UI 元素)。block-development-examples仓库是另一个有用的参考。 - 最终用户文档: 此文档网站面向最终用户(而非开发者),您还可以在此找到关于区块编辑器和使用区块的文档。
您是否来对地方了?
区块编辑器手册是为那些希望为区块编辑器创建和开发内容的人员设计的。然而,重要的是要注意,在开发者资源中还有其他可用的手册,您可能觉得有益: