gutenbergdocs/reference-guides/theme-json-reference/theme-json-v1.md

Theme.json 版本1参考文档

本文档是 theme.json 版本1 的技术规范。该版本适用于 WordPress 5.8 及以上版本。

Theme.json 版本2 已随 WordPress 5.9 发布。WordPress 将继续支持 theme.json 版本1，但新功能将仅添加到新版本文档中。

当您准备升级时，请参阅 theme.json 迁移指南了解更新至最新版本的详细信息。

本参考指南列出了 theme.json 架构中定义的设置项和样式属性。关于如何在主题中使用 theme.json 文件的示例与指导，请参阅 theme.json 使用指南。

JSON 架构

版本1的最终架构文件位于：https://schemas.wp.org/wp/5.8/theme.json

各 WordPress 版本对应的 Theme.json 架构文件路径为：https://schemas.wp.org/wp/{{version}}/theme.json。例如 WordPress 5.8 的架构文件地址为：https://schemas.wp.org/wp/5.8/theme.json。

关于如何在编辑器中运用 JSON 架构，请参阅使用 theme.json 进行开发。

设置项

边框

与边框相关的设置。

属性	类型	默认值	参数
customRadius	boolean	false

---

颜色

与颜色相关的设置。

属性	类型	默认值	参数
custom	boolean	true
customDuotone	boolean	true
customGradient	boolean	true
duotone	array		colors, name, slug
gradients	array		gradient, name, slug
link	boolean	false
palette	array		color, name, slug

---

布局

与布局相关的设置。

属性	类型	默认值	参数
contentSize	string
wideSize	string

---

间距

与间距相关的设置。

属性	类型	默认值	参数
customMargin	boolean	false
customPadding	boolean	false
units	array	px,em,rem,vh,vw,%

---

排版

与排版相关的设置。

属性	类型	默认值	参数
customFontSize	boolean	true
customLineHeight	boolean	false
dropCap	boolean	true
fontSizes	array		name, size, slug

---

自定义

生成格式为 --wp--custom--{键名}--{嵌套键名}: {值}; 的自定义 CSS 属性。驼峰式命名的键名将转换为短横线命名法以遵循 CSS 属性命名规范。不同层级的键名通过 -- 分隔，因此键名中不应包含 --。

---

样式

边框

边框样式。

属性	类型	参数
radius	string

---

颜色

颜色样式。

属性	类型	参数
background	string
gradient	string
text	string

---

间距

间距样式。

属性	类型	参数
margin	object	bottom, left, right, top
padding	object	bottom, left, right, top

---

排版

排版样式。

属性	类型	参数
fontSize	string
lineHeight	string