stillat/antlers-layouts

此包最新版本(v2.1.0)没有可用的许可信息。

v2.1.0 2024-05-11 19:56 UTC

This package is auto-updated.

Last update: 2024-09-11 20:42:14 UTC


README

Antlers Layouts 是一个 Statamic 插件,允许您扩展任意布局并将数据传递到模板布局中。

特性

此插件

  • 允许您从 Antlers 模板内部扩展任意布局;
  • 从模板传递数据到布局

如何安装

您可以从项目根目录运行以下命令来安装此插件

composer require stillat/antlers-layouts

如何使用

Antlers Layouts 插件提供了一个单个的 layout 标签,允许您扩展任意布局并将数据传递到模板布局。在 Statamic 项目中组织多个布局的推荐方法是,在以下位置创建一个新文件夹以包含您的额外布局模板

resources/views/layouts/

假设我们有一个名为 resources/views/layouts/custom-layout.antlers.html 的文件,我们可以在模板的任何位置包含以下 Antlers 标签以动态切换到此布局

{{ layout:layouts/custom-layout }}

包含此标签后,Antlers 将现在使用 resources/views/layouts/custom-layout.antlers.html 文件作为我们的布局,而不是正常的 resources/views/layout.antlers.html 文件。

我们可以使用 layout:share 标签将数据传递到我们的 Antlers 布局文件

{{ layout:share variable_one="Value One"
                variable_two="Another value"
                :variable_three="title" /}}

需要注意的是,layout:share 标签只会将自定义变量传递到标准 layout.antlers.html 模板文件,以及位于 resources/views/layouts/ 文件夹中的自定义布局。

我们使用 layout:share 标签创建的自定义变量现在将在布局文件中像其他任何变量一样可用

{{# Inside the layout template. #}}

{{ variable_one }}
{{ variable_two }}
{{ variable_three }}

许可

Antlers Layouts 是在 MIT 许可下发布的免费软件。