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>