外观工具

settings.appearanceTools 是 theme.json 中的一个独特属性，它充当多个其他属性的通用容器。与其他可配置的设置相比，此设置可以轻松一次性启用多个设计相关设置。

选择使用外观工具

settings.appearanceTools 可以启用与站点的设计或 外观 相关的几个功能。默认情况下，该值设置为 false，因此如果您选择不使用该属性，只需不要将其添加到您的 theme.json 中即可。

但是，如果您想启用它，可以将其设置为 true：

{
	"version": 2,
	"settings": {
		"appearanceTools": true
	}
}

这相当于在 theme.json 中单独设置这些属性：

{
	"version": 2,
	"settings": {
		"border": {
			"color": true,
			"radius": true,
			"style": true,
			"width": true
		},
		"color": {
			"link": true
		},
		"dimensions": {
			"minHeight": true
		},
		"position": {
			"sticky": true
		},
		"spacing": {
			"blockGap": true,
			"margin": true,
			"padding": true
		},
		"typography": {
			"lineHeight": true
		}
	}
}

正如您所看到的，它可以节省大量时间并为您减少许多工作。启用 settings.appearanceTools 后，您可以跳过单独设置这些属性。

您可以在手册中的此处通过其文档了解每个属性的具体作用：

• 边框
• 颜色
• 尺寸
• 位置
• 间距
• 排版

覆盖外观工具

仅仅启用了 appearanceTools 并不意味着您无法禁用某些功能。您可以同时做到这两点。

假设您想启用所有外观工具但禁用粘性定位。您可以在 theme.json 中使用以下代码来实现此目的：

{
	"version": 2,
	"settings": {
		"appearanceTools": true,
		"position": {
			"sticky": false
		}
	}
}

这让您兼得两者的好处。您可以使用 appearanceTools 启用大量设置，但可以根据具体情况禁用其他设置。

我应该启用外观工具吗？

在您的 theme.json 文件中将 appearanceTools 设置为 true 时有一个注意事项：它可能会自动让您的主题在未来加入设计工具。有时，WordPress 会在启用此设置时启用新功能。

由于没有人能可靠地预测未来，您需要决定是否希望您的主题支持您今天尚未测试的未知设计功能。

对于许多公开发布的主题来说，如果您想为您的主题用户提供大量灵活性，这通常不会成为一个问题。通过启用 appearanceTools，您可以在不更新主题的情况下为用户提供新的设计功能。

对于代理机构和自由职业者来说，这可能会给您的客户带来问题。通常，这些项目旨在将用户界面限制为客户需要的特定设计工具。如果 WordPress 在未来的更新中添加了新的外观工具，客户可能会看到新且不熟悉的功能。因此，禁用 appearanceTools 通常是有意义的。