跳转到正文

区块属性

$attributes 或 $a 变量只能访问 blockstudio 属性中注册的数据。要访问对齐或排版等标准 WordPress 区块数据,请使用 $block 或 $b 变量。

渲染

PHP

PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>

Twig

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 键:

JSON
{
  "$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 区块功能:

JSON
{
  "supports": {
    "align": true,
    "anchor": true,
    "customClassName": true,
    "color": {
      "background": true,
      "text": true
    },
    "spacing": {
      "margin": true,
      "padding": true
    },
    "typography": {
      "fontSize": true,
      "lineHeight": true
    }
  }
}

如需查看所有可用选项,请参阅 WordPress区块支持文档。