本规范适用于版本2属于主题.json。此版本适用于WordPress 5.9或更高版本。
Theme.json版本3已经发布了WordPress 6.6。WordPress将继续支持theme.json版本2。然而，新功能只会添加到[新版本](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json生活/).
准备升级时，请参阅[theme.json迁移指南](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json迁移/#migrating-从v2-v3）获取更新到最新版本的详细信息。
本参考指南列出了主题.json模式。请参阅主题.json如何指导有关如何使用主题.json在主题中创建文件。
此文档是根据theme.JSON的JSON模式生成的。
版本2的最后一个架构位于`https://schemas.wp.org/wp/6.5/theme.json网站`.
每个WordPress版本的Theme.json模式可在https://schemas.wp.org/wp/｛｛version｝｝/theme.json`。例如，WordPress 5.9的模式可在https://schemas.wp.org/wp/5.9/theme.json网站`.
请参见使用theme.json开发了解如何在编辑器中使用JSON模式。
启用以下UI工具的设置：
- 背景：backgroundImage，background Size
- 边框：颜色、半径、样式、宽度
- 颜色：链接
- 尺寸：纵横比，最小高度
- 位置：粘性
- 间距：块间距、边距、填充
- 排版：lineHeight
启用根填充（来自样式.间距.填充)应用于全宽块而不是根块的内容。
请注意，使用此设置时，样式.间距.填充应始终设置为具有顶部,正确的,底部,左边单独声明的值。
与边框相关的设置。
| 财产 |
类型 |
违约 |
道具 |
| 颜色 |
布尔值 |
假 |
|
| 半径 |
布尔值 |
假 |
|
| 风格 |
布尔值 |
假 |
|
| 宽度 |
布尔值 |
假 |
|
与阴影相关的设置。
| 财产 |
类型 |
违约 |
道具 |
| 默认预设 |
布尔值 |
真实的 |
|
| 预设 |
阵列 |
|
名字、影子、鼻涕虫 |
与颜色相关的设置。
| 财产 |
类型 |
违约 |
道具 |
| 背景 |
布尔值 |
真实的 |
|
| 习俗 |
布尔值 |
真实的 |
|
| 自定义双音 |
布尔值 |
真实的 |
|
| 自定义渐变 |
布尔值 |
真实的 |
|
| 默认双音 |
布尔值 |
真实的 |
|
| 默认坡度 |
布尔值 |
真实的 |
|
| 默认调色板 |
布尔值 |
真实的 |
|
| 双色调 |
阵列 |
|
颜色、名称、slug |
| 梯度 |
阵列 |
|
梯度、名称、段塞 |
| 链接 |
布尔值 |
假 |
|
| 调色板 |
阵列 |
|
颜色、名称、段塞 |
| 文本 |
布尔值 |
真实的 |
|
| 标题 |
布尔值 |
真实的 |
|
| 按钮 |
布尔值 |
真实的 |
|
与背景相关的设置。
与标注相关的设置。
| 财产 |
类型 |
违约 |
道具 |
| 纵横比 |
布尔值 |
假 |
|
| 最小高度 |
布尔值 |
假 |
|
与布局相关的设置。
| 财产 |
类型 |
违约 |
道具 |
| 内容大小 |
一串 |
|
|
| 宽尺寸 |
一串 |
|
|
| 允许编辑 |
布尔值 |
真实的 |
|
| 允许自定义内容和宽尺寸 |
布尔值 |
真实的 |
|
与灯箱相关的设置。
| 财产 |
类型 |
违约 |
道具 |
| 启用 |
布尔值 |
|
|
| 允许编辑 |
布尔值 |
|
|
与位置相关的设置。
与间距相关的设置。
| 财产 |
类型 |
违约 |
道具 |
| 块间隙 |
布尔值，空 |
无效的 |
|
| 边缘 |
布尔值 |
假 |
|
| 衬垫 |
布尔值 |
假 |
|
| 单位 |
阵列 |
像素、em、rem、vh、vw、% |
|
| 自定义间距大小 |
布尔值 |
真实的 |
|
| 间距大小 |
阵列 |
|
名称、大小、段塞 |
| 间距比例 |
对象 |
|
|
与排版相关的设置。
| 财产 |
类型 |
违约 |
道具 |
| 自定义字体大小 |
布尔值 |
真实的 |
|
| 字体样式 |
布尔值 |
真实的 |
|
| fontWeight（字体重量） |
布尔值 |
真实的 |
|
| 流体 |
对象，布尔 |
假 |
{最大视点宽度，最小字体大小，最小视点宽度} |
| 字母间距 |
布尔值 |
真实的 |
|
| 线条高度 |
布尔值 |
假 |
|
| text列 |
布尔值 |
假 |
|
| text装饰 |
布尔值 |
真实的 |
|
| 写入模式 |
布尔值 |
假 |
|
| text转换 |
布尔值 |
真实的 |
|
| dropCap（下降上限） |
布尔值 |
真实的 |
|
| 字体大小 |
阵列 |
|
流体、名称、尺寸、段塞 |
| font系列 |
阵列 |
|
fontFace，fontFamily，名称，slug |
生成表单的自定义CSS自定义属性--wp—自定义--{键}--{nested-key}:{value}；.带骆驼皮的键被转换为烤肉串以遵循CSS属性命名模式。不同深度级别的按键由分隔--，因此键不应包括--以名字命名。
边框样式。
| 财产 |
类型 |
道具 |
| 颜色 |
字符串，对象 |
|
| 半径 |
字符串，对象 |
|
| 风格 |
字符串，对象 |
|
| 宽度 |
字符串，对象 |
|
| 顶部 |
对象 |
颜色、样式、宽度 |
| 正确的 |
对象 |
颜色、样式、宽度 |
| 底部 |
对象 |
颜色、样式、宽度 |
| 左边 |
对象 |
颜色、样式、宽度 |
颜色样式。
| 财产 |
类型 |
道具 |
| 背景 |
字符串，对象 |
|
| 梯度 |
字符串，对象 |
|
| 文本 |
字符串，对象 |
|
标注样式
| 财产 |
类型 |
道具 |
| 纵横比 |
字符串，对象 |
|
| 最小高度 |
字符串，对象 |
|
间距样式。
| 财产 |
类型 |
道具 |
| 块间隙 |
字符串，对象 |
|
| 边缘 |
对象 |
底部、左侧、右侧、顶部 |
| 衬垫 |
对象 |
底部、左侧、右侧、顶部 |
排版风格。
| 财产 |
类型 |
道具 |
| 字体系列 |
字符串，对象 |
|
| 字体大小 |
字符串，对象 |
|
| 字体样式 |
字符串，对象 |
|
| fontWeight（字体重量） |
字符串，对象 |
|
| 字母间距 |
字符串，对象 |
|
| 线条高度 |
字符串，对象 |
|
| text列 |
一串 |
|
| text装饰 |
字符串，对象 |
|
| 写入模式 |
字符串，对象 |
|
| text转换 |
字符串，对象 |
|
CSS和SVG过滤器样式。
长方体阴影样式。
轮廓样式。
| 财产 |
类型 |
道具 |
| 颜色 |
字符串，对象 |
|
| 抵消 |
字符串，对象 |
|
| 风格 |
字符串，对象 |
|
| 宽度 |
字符串，对象 |
|
设置自定义CSS以应用其他theme.json属性未涵盖的样式。
模板文件夹中定义的自定义模板的其他元数据。
类型：对象.
| 财产 |
描述 |
类型 |
| 名称 |
模板文件夹中模板的文件名（不带扩展名）。 |
一串 |
| 标题 |
模板的标题，可翻译。 |
一串 |
| 帖子类型 |
可以使用此自定义模板的帖子类型列表。 |
阵列 |
零件文件夹中定义的模板零件的其他元数据。
类型：对象.
| 财产 |
描述 |
类型 |
| 名称 |
零件文件夹中模板的文件名（不带扩展名）。 |
一串 |
| 标题 |
模板的标题，可翻译。 |
一串 |
| 地区 |
模板零件用于的区域。的块变体收割台和页脚值存在，并将在区域设置为其中之一时使用。 |
一串 |
要从模式目录中注册的模式段塞数组。
类型：阵列.