WordPress 主题开发：按块设置样式（Blocks Settings）
在 WordPress 主题开发中，theme.json 文件承担着定义全局样式和设置的重任。但很多时候，你希望某个特定区块（比如封面块）拥有与众不同的配色或间距，而不是与全站统一。这时就需要用到按块设置（Block Settings）。本文会详细讲解如何在 theme.json 中为指定块覆盖全局配置，包括颜色调色板、边框、间距等各类属性。同时，我们会说明默认块设置的存在及其对主题的影响，帮你避开常见的开发误区。无论你是想微调某个块的外观，还是为整个主题赋予更精细的控制力，这份指南都会为你提供清晰、可操作的方向。
理解全局设置与块设置的关系
在 theme.json 中，settings 节点下的属性通常是全局生效的。例如：
json
{
"version": 2,
"settings": {
"color": {
"palette": [
{ "color": "#0284c7", "name": "Base", "slug": "base" },
{ "color": "#ffffff", "name": "Contrast", "slug": "contrast" }
]
}
}
}
这段代码定义了一套全局颜色调色板，所有支持颜色选择的块都会使用这组颜色。但是，当你想让 封面块（Cover block） 单独使用一套橙色系配色时，就需要用到 settings.blocks 这个属性。
json
{
"version": 2,
"settings": {
"color": {
"palette": [
{ "color": "#0284c7", "name": "Base", "slug": "base" },
{ "color": "#ffffff", "name": "Contrast", "slug": "contrast" }
]
},
"blocks": {
"core/cover": {
"color": {
"palette": [
{ "color": "#ea580c", "name": "Base", "slug": "base" },
{ "color": "#fff7ed", "name": "Contrast", "slug": "contrast" }
]
}
}
}
}
}
块级设置的结构与全局设置完全一致，只是多了一层 blocks 包裹，并在其后指定具体的块标识符（如 core/cover）。这样，封面块会优先使用自身定义的调色板，而其他块依然沿用全局调色板。
覆盖与优先级
块级设置会 覆盖 全局设置中同名的属性。这在实际开发中非常实用，因为你可以在全局层面建立一套统一的风格体系，然后为特定块（如按钮、引用、封面等）做精细化调整，而不必担心影响其他部分。
注意：并不是所有块都支持所有 theme.json 中的属性。某个属性是否生效，取决于块本身是否在代码中声明了对该特性的支持。通常，核心 WordPress 块会支持大部分常用功能，三方块则需要查阅其 block.json 文件来确认。
如何确定块的标识符
当你需要为某个块做专属配置时，必须先知道它的 命名空间（namespace） 和 块名（slug）。二者组合在一起形成类似 core/paragraph 或 core/cover 的字符串。
- 核心块：所有 WordPress 内置块都使用
core命名空间。 - 三方块：一般由插件定义，命名空间通常是插件名称或缩写，具体可在对应块的
block.json中查找。
例如，core/button 代表按钮块，core/pullquote 代表拉引号块。
WordPress 默认的块设置
WordPress 自身在 theme.json 中为少数几个块预设了默认设置，主要是为了向后兼容旧版本特性。具体来说：
- 按钮块（core/button）：默认开启了边框圆角（
border.radius）。 - 拉引号块（core/pullquote）：默认开启了边框的颜色、圆角、样式和宽度。
这相当于 WordPress 在底层已经为这两个块配置了部分样式支持。如果你在全局设置中关闭了边框功能，但发现按钮块依然可以设置圆角，很可能就是因为这个默认块设置的存在。
如果你希望彻底统一行为，可以在自己的 theme.json 中显式覆盖这些默认值：
json
{
"version": 2,
"settings": {
"blocks": {
"core/button": {
"border": {
"radius": false
}
},
"core/pullquote": {
"border": {
"color": false,
"radius": false,
"style": false,
"width": false
}
}
}
}
}
实战建议
- 优先建立全局风格：先定义好全局的颜色、排版、间距体系，确保整个站点拥有一致的基础体验。
- 按需覆盖特定块：当某个块有独特的设计需求时，使用
settings.blocks进行定制，这样既能保持全局一致性，又能灵活应对特殊场景。 - 注意默认块设置的影响：如果你发现按钮或拉引号块的行为与预期不符，可以检查是否被 WordPress 的默认设置所影响，并在自己的配置中显式覆盖。
- 查阅 block.json：对于三方块，务必查看其
block.json文件，确认它支持哪些theme.json属性，避免配置无效。
总结
theme.json 的按块设置功能为 WordPress 主题开发提供了精细化的控制能力。通过 settings.blocks，你可以在保持全局风格统一的前提下，为任何支持主题设置的块定制专属样式。理解全局与块级配置的覆盖关系，以及 WordPress 自带的默认块设置，能够帮助你写出更清晰、更可预测的主题配置。在实际项目中，善用这一机制，可以显著提升主题的灵活性和设计品质。