theme.json 文件中的 settings.border 属性允许您控制 WordPress 中块元素的全局边框设置。需要注意的是,该属性用于配置用户界面中显示的设置选项,而非边框本身的样式。

每一个边框设置都对应着单个块元素级别以及块元素 Styles 界面中的相应控制选项,这样您就可以决定为主题用户提供哪些控制选项:

显示带有自定义边框设置的文章特色图片块的 WordPress 文章编辑器界面。

边框设置

WordPress 支持四种边框设置,您可以通过 theme.json 文件中的 settings.border 属性来对其进行配置。每种设置都可以用来启用或禁用特定的边框功能,且都接受布尔值(true 或 false)作为输入:

  • color:用于启用或禁用边框颜色选择器。
  • radius:用于启用或禁用边框圆角控制选项。
  • style:用于启用或禁用边框样式选择器(用户可以选择 solid、dashed 或 dotted 等样式)。
  • width:用于启用或禁用边框宽度输入框。

默认情况下,所有的边框属性都设置为 false,如下所示的 theme.json 代码示例:

{
	"version": 2,
	"settings": {
		"border": {
			"color": false,
			"radius": false,
			"style": false,
			"width": false
		}
	}
}

从 WordPress 6.3 版本开始,color、style 和 width 这三个属性是相互关联的。只要其中任意一个被设置为 true,其他两个就会作为选项出现在用户界面中。

另外,对于按钮块而言,将 radius 设置为 false 是无效的——编辑器中的边框圆角控制选项始终会显示出来。