gutenbergdocs/docs/getting-started/glossary.md
2025-10-22 01:40:18 +08:00

139 lines
6.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 工具栏
一组按钮控件。在区块环境中,通常指选中区块上方显示的区块控制工具栏。
# 术语表
## 属性来源
描述区块属性结构的对象。其键名可根据需要自由命名以描述区块类型的状态。每个键对应的值是一个函数,描述从已保存文章内容中提取属性值的策略。处理时会根据属性来源定义的键创建新对象,其中每个值都是属性来源函数的执行结果。
## 属性
表征文章内容中区块当前状态的对象。加载已保存文章时,该对象由对应区块类型的属性来源决定。在编辑过程中,这些值会随着用户修改区块而产生变化,并在序列化区块时被使用。
## 区块
用于描述标记单元的抽象术语这些单元组合后构成网页的内容或布局。该概念将WordPress中通过短代码、自定义HTML和嵌入发现实现的功能整合为统一的API和用户体验。
## 区块样式
通过样式表或区块标记本身实现的CSS样式。例如附加在区块标记上的类即被视为区块样式。
对比<a href="#global-styles">全局样式</a>。与全局样式相对,区块样式有时也被称作<a href="#local-styles">局部样式</a>
了解更多关于[区块样式](/docs/explanations/architecture/styles.md#block-styles)的内容。
## 区块支持
供区块声明支持功能的API。通过声明对某项功能的支持该API会为区块添加额外的<a href="#attributes">属性</a>并为大多数现有区块支持功能提供匹配的UI控件。
参阅<a href="https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/">区块支持参考文档</a>深入了解该API。
## 区块主题
采用区块优先方式构建的主题支持全站编辑功能。区块主题的核心是其区块模板和区块模板部件。截至目前区块主题模板是由区块标记组成的HTML文件对应标准WordPress模板层级中的模板。
## 区块分类
这些并非WordPress的分类法而是在区块库中用于内部排序区块的机制。
## 区块~插入器~库
选择可用区块的主要界面,通过区块上的加号图标按钮或编辑器界面左上角的按钮触发。
## 区块名称
区块类型的唯一标识符,由插件特定命名空间和描述区块用途的简短标签组成。例如:<code>core/image</code>
## 区块模板
预定义区块排列方式的模板,可能包含预定义属性或占位内容。您可以为文章类型提供模板,为用户创建新内容时提供起点,或在自定义区块中通过<code>InnerBlocks</code>组件使用模板。本质上模板是由区块标记组成的HTML文件对应标准WordPress模板层级中的模板如索引页、单篇文章页或归档页。这有助于控制未通过页面编辑器或文章编辑器修改的网站前端默认样式。更多信息请参阅<a href="../../developers/block-api/block-templates/">模板文档</a>
## 区块模板部件
在区块模板基础上构建这些部件帮助设置可复用项目如页脚或页眉的结构这些结构在WordPress站点中十分常见。它们主要构成站点结构绝不能与文章内容编辑器混用。通过全站编辑和基于区块的主题用户可以创建自定义模板部件将其保存至站点数据库并在整个站点中重复使用。模板部件在区块体系中相当于主题模板部件通常由主题首先定义具有特定语义可在不同主题间互换如页眉且只能在站点编辑器环境中“模板”内插入。
## 区块类型
与构成特定文章的区块不同,区块类型描述了该类区块应有的行为蓝图。因此,虽然一篇文章中可能包含多个图片区块,但每个图片区块都遵循统一的图片区块类型定义。
## 经典区块
将 TinyMCE 编辑器作为区块嵌入的区块类型。TinyMCE 是旧版核心编辑器的基础。在区块编辑器之前创建的旧内容将被加载到单个经典区块中。
## 动态区块
这类区块的内容可能发生变化,且在保存文章时无法确定具体内容,而是在文章显示于网站前端时实时计算生成。这类区块在其 JavaScript 实现中可能保存备用内容或不保存任何内容,转而依赖 PHP 区块实现在运行时进行渲染。
## 全站编辑
指一系列功能的集合,最终允许用户以区块为起点编辑整个网站。该功能集涵盖从区块模式到全局样式,从模板到区块设计工具(及更多)的所有内容。首次发布于 WordPress 5.9。
## 全局样式
由 WordPress 生成并作为嵌入式样式表排入网站前端的 CSS 样式。该样式表 ID 为 `global-styles-inline-css`。其内容来源于 WordPress 默认的 `theme.json`、主题的 `theme.json` 以及用户通过网站编辑器中全局样式侧边栏提供的样式。
详见[theme.json 参考文档](/docs/reference-guides/theme-json-reference/README.md)、[操作指南](/docs/how-to-guides/themes/global-settings-and-styles.md)以及[区块编辑器样式介绍](/docs/explanations/architecture/styles.md)。
对比<a href="#block-styles">区块样式</a>
## 检查器
已弃用术语。参见<a href="#settings-sidebar">设置侧边栏</a>
## 本地样式
参见<a href="#block-styles">区块样式</a>
## 导航区块
允许编辑网站导航菜单结构和设计的区块。
## 模式
模式是预定义的区块布局,可作为初始内容插入,每次插入后都需要用户进行修改。一旦插入,它们将以本地保存形式存在,不具备全局性。
## 文章设置
包含文章元数据字段的侧边栏区域,包括发布时间安排、可见性、分类项和特色图片。
## 查询区块
复制经典 WP_Query 功能并支持通过附加功能进行进一步自定义的区块。
## 可复用区块
保存后可作为可复用内容片段共享的区块。
## 富文本
支持富内容编辑的通用组件,包括粗体、斜体、超链接等功能。
## 序列化
将区块属性对象转换为 HTML 标记的过程,每次编辑区块时都会执行此操作。
## 设置侧边栏
右侧包含文档和区块设置的面板。可通过设置齿轮图标切换侧边栏显示。选中区块时显示区块设置,否则显示文档设置。
## 网站编辑器
允许直接编辑各种模板、模板部件、样式选项等并可在其间导航的完整操作体验。
## 静态区块
这类区块的内容在保存文章时即可确定。静态区块的 HTML 标记将直接保存在文章内容中。
## 模板编辑模式
精简的直接编辑体验,允许编辑/更改/创建文章/页面使用的模板。
## 主题区块
通过传统模板标签实现所有功能的区块(例如:文章作者区块)。完整列表可在[此处](https://github.com/WordPress/gutenberg/issues/22724)查看。
## TinyMCE
<a href="https://www.tinymce.com/">TinyMCE</a> 是一款基于 JavaScript 的网页所见即所得编辑器。