区块属性
$attributes 或 $a 变量只能访问 blockstudio 属性中注册的数据。要访问对齐或排版等标准 WordPress 区块数据,请使用 $block 或 $b 变量。
渲染
PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>
Twig
<h1>The block is aligned: {{ block.align }}</h1>
<h1>The block is aligned: {{ b.align }}</h1>
设置默认值
保留字段 ID
由 WordPress 管理的属性不得声明为具有相同顶层 ID 的 Blockstudio 字段。anchor、className、style、lock 和 metadata 均为保留项;Blockstudio 的内部 blockstudio、__BLOCKSTUDIO_KEY 和 blockEditingMode 属性也同样保留。
已启用的 WordPress 支持也会保留相应属性名称(如适用):align、backgroundColor、textColor、gradient、fontSize、fontFamily、layout、borderColor、shadow 和 ariaLabel。原生声明这些属性之一也会保留相应名称。这样可以避免用选择字段的选项对象替换核心中的字符串 align 等情况。
注册时会跳过冲突字段,并通过 blockstudio/error/logged 记录日志(启用时也会写入 WordPress 调试日志),其中会注明区块和字段。不会注册这些字段的编辑器控件、存储处理程序和渲染定义。请将字段重命名为 headingAlign,或将其放入名为 presentation 的组中,以生成 presentation_align。重复器行字段位于各自的行内,不属于顶层冲突。禁用对齐支持且不存在原生 align 属性时,普通的 align 字段仍然有效。
升级存在冲突的现有区块时,请重命名其字段,并将已保存的字段值迁移到新 ID。Blockstudio不会自动重命名已存储的内容,也不会移除WordPress支持。
原生属性默认值
要为 WordPress 属性(例如 align)设置默认值,请在 attributes 键中添加一个 default 键:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/block",
"title": "Native Block",
"icon": "star-filled",
"description": "Native Block.",
"supports": {
"align": ["left", "center", "right"]
},
"attributes": {
"align": {
"type": "string",
"default": "center"
}
},
"blockstudio": true
}
可用的区块数据
$block / $b 变量包含:
| 属性 | 说明 |
|---|---|
name |
区块名称(e.g、my-theme/my-block) |
title |
区块标题 |
dir |
区块目录路径 |
url |
区块目录 URL |
align |
对齐值(如果启用了 supports.align) |
className |
自定义 CSS 类(如果启用了 supports.customClassName) |
anchor |
HTML 锚点/ID(如果启用了 supports.anchor) |
WordPress 支持
通过 supports 属性启用 WordPress 区块功能:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
如需查看所有可用选项,请参阅 WordPress区块支持文档。