设置参考

最后更新：2026-10-05 15:56:51

该文档是可供配置的属性的参考，您可以通过 theme.json 中的 settings 对象进行配置。每个设置都有深入的使用指南，请参阅设置文档。

外观工具

settings.appearanceTools 是一个顶级属性，其下没有嵌套子属性。有关该属性的文档请参阅设置：外观工具。

属性	类型	默认值
`appearanceTools`	布尔值	`false`

settings.border 是一个对象，支持在下表中列出的嵌套属性。有关该属性的文档请参阅设置：边框。

启用 color、style 或 width 设置中的任何一个将自动启用其他两个，因为这些属性是相互关联的。

settings.color 是一个对象，支持在下表中列出的嵌套属性。有关该属性的文档请参阅设置：颜色。

settings.custom 是一个对象，支持任意数量的嵌套自定义属性，如下表所示。有关该属性的文档请参阅设置：自定义。

属性	类型	默认值
`custom.<custom>`	任意	—

settings.dimensions 是一个对象，支持在下表中列出的嵌套属性。有关该属性的文档请参阅设置：尺寸。

属性	类型	默认值
`minHeight`	布尔值	`false`

settings.layout 是一个对象，支持在下表中列出的嵌套属性。有关该属性的文档请参阅设置：布局。

属性	类型	默认值
`contentSize`	字符串	`""`
`wideSize`	字符串	`""`

settings.lightbox 是一个对象，支持在下表中列出的嵌套属性。有关该属性的文档请参阅设置：灯箱。

属性	类型	默认值
`allowEditing`	布尔值	`true`
`enabled`	布尔值	`false`

此设置仅在 WordPress 6.4 中可用，并且专门针对核心图像块 (core/image)。

settings.position 是一个对象，支持在下表中列出的嵌套属性。有关该属性的文档请参阅设置：位置。

属性	类型	默认值
`sticky`	布尔值	`false`

settings.shadow 是一个对象，支持在下表中列出的嵌套属性。有关该属性的文档请参阅设置：阴影。

属性	类型	默认值	属性
`defaultPresets`	布尔值	`true`
`presets`	数组 <对象>	`数组`	`name`, `shadow`, `slug`

settings.spacing 是一个对象，支持在下表中列出的嵌套属性。有关该属性的文档请参阅设置：间距。

属性	类型	默认值	属性
`blockGap`	布尔值\|null	`null`	—
`customSpacingSize`	布尔值	`true`	—
`margin`	布尔值	`false`	—
`padding`	布尔值	`false`	—
`spacingScale`	对象	`对象`	`operator`, `increment`, `steps`, `mediumStep`, `unit`
`spacingSizes`	数组 <对象>	`数组`	`name`, `size`, `slug`
`units`	数组 <字符串>	`[ "px", "em", "rem", "vh", "vw", "%" ]`	—

settings.typography 是一个对象，支持在下表中列出的嵌套属性。有关该属性的文档请参阅设置：排版。

属性	类型	默认值	属性
`customFontSize`	布尔值	`true`	—
`dropCap`	布尔值	`true`	—
`fontFamilies`	数组 <对象>	`数组`	`fontFace`, `fontFamily`, `name`, `slug`
`fontSizes`	数组 <对象>	`数组`	`fluid`, `name`, `size`, `slug`
`fontStyle`	布尔值	`true`	—
`fontWeight`	布尔值	`true`	—
`fluid`	布尔值	`false`	—
`letterSpacing`	布尔值	`true`	—
`lineHeight`	布尔值	`false`	—
`textColumns`	布尔值	`false`	—
`textDecoration`	布尔值	`true`	—
`textTransform`	布尔值	`true`	—
`writingMode`	布尔值	`false`	—

settings.useRootPaddingAwareAlignments 是一个顶级属性，其下没有嵌套子属性。有关该属性的文档请参阅设置：使用根内边距感知对齐。

属性	类型	默认值
`useRootPaddingAwareAlignments`	布尔值	`false`

此设置与 theme.json 中的 styles.spacing.padding 一起工作。如果启用，styles.spacing.padding 必须是一个定义 top、right、bottom 和 left 样式的对象。