title: "核心概念" post_status: publish comment_status: open taxonomy: category: - gutenberg-docs post_tag: - Architecture - Explanations - Repos
核心概念
区块
区块是用于构建和交互内容的抽象单元。当它们组合在一起时,就构成了网页的内容。从段落、视频到网站标题,所有内容都以区块的形式呈现。
区块形式多样,但提供一致的接口。它们可以被插入、移动、重新排序、复制、重复、转换、删除、拖拽和组合。区块还可以被重用,允许在不同文章和文章类型之间共享,或在同一文章中多次使用。如果有助于理解,您可以将区块视为更优雅的短代码,为用户提供丰富的格式工具来创作内容。
区块的设置和内容可以在三个主要位置进行自定义:区块画布、区块工具栏和区块检查器。
可组合性
区块设计用于以不同方式组合。区块具有层次结构,一个区块可以嵌套在另一个区块内。嵌套区块及其容器分别称为子区块和父区块。例如,多栏区块可以作为其各栏中多个子区块的父区块。管理子区块使用的 API 名为 InnerBlocks。
数据和属性
区块将内容理解为属性,并可序列化为 HTML。为此,引入了一种新的区块语法。简而言之,区块语法是一种 HTML 注释,可以是自闭合标签,也可以包含开始标签和结束标签。在主标签中,根据区块类型和用户自定义设置,可以包含一个 JSON 对象。区块的这种原始形式被称为序列化。
<!-- wp:paragraph {"key": "value"} -->
<p>欢迎来到区块的世界。</p>
<!-- /wp:paragraph -->
区块可以是静态的或动态的。静态区块包含已渲染的内容和一个属性对象,用于根据变化重新渲染。动态区块在生成(渲染)文章内容时需要服务器端数据和渲染。
每个区块都包含属性或配置设置,这些可以从内容中的原始 HTML 通过元数据或其他可自定义的来源获取。
更多信息请参阅数据格式和数据流。
区块转换
区块具备转换为其他区块类型的能力。这支持基础操作(如将段落转换为标题),也支持复杂转换(如将多张图片转换为画廊)。区块转换适用于单个区块和多区块选区,内部区块变体也可作为转换目标。
区块变体
区块变体是针对特定区块类型预设的初始属性集合。该 API 允许创建单一区块,并支持多种配置方式。变体提供了不同的界面可能性,包括在区块库中显示为全新区块,或在插入新块时作为预设选项。更多详情请参阅 API 文档。
更多区块相关
可重用区块
可重用区块是一个区块实例(或多个区块),可在多处插入和编辑,并保持各处同步。如果在某处编辑可重用区块,这些更改将反映在使用该区块的所有文章和页面中。可重用区块的示例包括:由标题和自定义颜色组成的区块(将出现在网站的多个页面上)以及将出现在每个页面上的侧边栏小部件。
对可重用区块的任何编辑都将出现在该区块的所有其他使用位置,从而节省了在不同文章中重复进行相同编辑的时间。
在内部,可重用区块存储为隐藏的文章类型(wp_block),并且是动态区块,它们“引用”或参考 post_id 并返回该区块的 post_content。
模式
区块模式 是一组组合在一起创建设计模式的区块。这些设计模式为快速构建更高级的页面和布局提供了起点,而无需逐个插入区块。一个区块模式可以小到单个区块,也可以大到一整页内容。与可重用区块不同,模式插入后不会与原始内容保持同步,因为其中包含的区块旨在供用户编辑和自定义。本质上,模式只是组合在一起的常规区块。主题可以注册模式,为用户提供符合该主题美学设计语言的快速起点。
模板
文章编辑器专注于文章内容,而模板编辑器则允许使用区块来声明和编辑整个站点,从页眉到页脚。模板分为模板(描述完整页面)和模板部件(描述模板内可重用的区域,包括页眉、侧边栏和页脚等语义区域)。
这些模板和模板部件可以由主题组合在一起并注册。用户也可以使用区块编辑器完全编辑它们;一组与站点不同属性和设置(如站点标题、描述、徽标、导航等)交互的区块在编辑模板和模板部件时特别有用。自定义模板保存在 wp_template 文章类型中。区块模板包括静态页面和动态页面,如归档、单篇文章、首页、404 页面等。
注意:自定义文章类型也可以用初始的 post_content 模板初始化,不应与上述主题模板系统混淆。
更多关于站点编辑模板。
样式
样式(在代码中仍沿用旧称“全局样式”)既是一个用户通过编辑器访问的界面,也是一个通过 theme.json 文件实现的配置系统。该文件整合了通常分散在各个 add_theme_support 调用中的大部分配置内容,以简化与编辑器的通信。因此,它旨在改进以下内容的声明:应启用哪些设置、主题提供哪些特定工具(如自定义调色板)、可用的设计工具,以及一个协调来自 WordPress、活动主题和用户的样式的基础架构。
了解更多关于全局样式的信息。