跳转到正文

Twig

Twig 是一款灵活、快速且安全的 PHP 模板引擎。它让开发者能够在模板中编写简洁易读的代码,从而提升生产力和可维护性。Twig 支持多种功能,让模板既强大又易于使用,因此非常适合需要稳健、可复用模板的项目。

设置

要在 Blockstudio 中使用 Twig 模板,请使用 Composer 安装 timber/timber 包(其中包含 Twig)。Blockstudio 会自动检测是否已安装 Timber,并为你的区块启用 Twig 模板功能。

命令行
composer require timber/timber

安装 Timber 后,Blockstudio 会自动处理区块文件夹中 index.twig 文件的渲染。

模板变量

所有 Twig 文件都可以访问 Timber 上下文,其中包含常见的 WordPress 数据和函数,以及特定于 Blockstudio 的变量:

变量 描述
a attributes 的别名
attributes 区块的属性
b block 的别名
block 与区块本身相关的数据(包括 postId、postType、context 等)
c context 的别名
context 区块上下文(e.g、postId、循环中的 postType)
isEditor 布尔值,在编辑器中渲染区块时为 true
isPreview 布尔值,在插入器预览中渲染区块时为 true

用法

要将 Twig 用作区块模板,只需在区块目录中创建一个 index.twig 文件。Blockstudio 随后会自动使用此文件来渲染区块。

Twig
<div class="my-block">
  {% if a.title %}
    <h2>{{ a.title }}</h2>
  {% endif %}

  {% if a.content %}
    <p>{{ a.content }}</p>
  {% endif %}
</div>