用途:在 WordPress 中通过 theme.json 配置区块样式,并可用 PHP 或 JSON 注册区块样式变体与全局样式变体。
主要能力:theme.json 的 settings 段可定义 layout(contentSize、wideSize)、颜色预设(palette、gradients、duotone)、排版(fontFamilies、fontSizes、fluid 流体排版)、间距(units、spacingScale、spacingSizes)、边框与阴影预设、尺寸与位置等。styles 段可设置全局样式、elements(link、heading、h1-h3、button 等)与按区块(core/paragraph、core/heading、core/button、core/group、core/columns、core/separator、core/quote、core/code、core/image、core/cover、core/navigation 等)的样式。支持在 styles.blocks 的 variations 中注册区块样式变体,或用 PHP 函数 register_block_style() 注册,也可用 styles/ 目录下的 JSON 文件注册。全局样式变体放在 /styles/ 目录,另有 CSS 自定义属性与自定义 CSS。
使用方式:编辑主题的 theme.json,按 version 3 结构写入 settings 与 styles;区块样式变体可写在 styles.blocks 下的 variations,或调用 register_block_style() 并配合 inline_style/style_handle;全局样式变体与区块样式 JSON 文件放入 styles/ 目录;样式引用 WordPress 生成的 CSS 变量(如 --wp--preset--color--primary、--wp--preset--spacing--50),自定义属性写在 settings.custom 下,自定义 CSS 写在 styles.css 或按区块的 css 字段。
适用场景:主题作者或站点开发者统一管理区块外观、创建配色与字体预设、提供多套全局样式变体(如深色模式、衬线字体),以及为特定区块添加变体与自定义 CSS。
限制:theme.json 版本与功能依赖 WordPress 版本(版本 1 对应 5.8+,版本 2 对应 5.9+,版本 3 对应 6.6+);部分能力如样式变体需较新版本;资料未提供具体安装命令、收费信息或性能效果说明。