设置

theme.json 中的 settings 属性允许您为 WordPress 安装配置各种设置。它涵盖了从颜色预设、启用排版设计工具、布局到中间的一切内容。

本文档包含有关这些设置的链接，每个设置都有自己独立的文档页面。

settings 属性

settings 是 theme.json 中的顶级属性，您可以定义多个嵌套属性。其中一些嵌套属性还有自己的多级嵌套。

以下是在 theme.json 文件上下文中对这些属性的总体概述：

{
	"version": 2,
	"settings": {
		"appearanceTools": false,
		"border": {},
		"color": {},
		"custom": {},
		"dimensions": {},
		"layout": {},
		"position": {},
		"shadow": {},
		"spacing": {},
		"typography": {},
		"useRootPaddingAwareAlignments": false,
		"blocks": {}
	}
}

设置文档

使用以下链接探索您可以在 theme.json 文件中配置的具体设置：

• appearanceTools: 用于启用多个其他设置的通用设置。
• border: 用于控制边框宽度、样式、颜色和半径。
• color: 允许您注册颜色调色板、渐变、双色图像并配置与颜色相关的设置。
• custom: 用于添加自定义设置的对象，这些设置输出为 CSS 自定义属性。
• dimensions: 允许您配置最小高度设置。
• layout: 用于设置布局属性，如内容和宽度的宽度。
• lightbox: 允许您配置图像灯箱功能。
• position: 目前允许您定义对粘性定位的支持。
• shadow: 允许您配置 box-shadow 支持并定义自定义阴影预设。
• spacing: 用于配置与间距相关的设置，例如边距和内边距，
• typography: 用于配置与排版相关的设置，定义自定义字体大小并注册字体家族。
• useRootPaddingAwareAlignments: 一个布尔设置，用于说明根元素上的内边距应如何工作。
• blocks: 用于配置每个块设置的对象。

The Theme Handbook 还维护了一个 可用设置参考，基于 theme.json 架构。