Liquid 基础知识

已完成

与任何传统编程语言类似，Liquid 定义了语法，可以使用变量定义，并且包括输出、逻辑等构造。 Liquid 构造可通过两组分隔符来识别：双括号分隔符 {{ }}，表示对象和变量的输出，以及括号百分比分隔符 {% %}，表示逻辑和控制流。

提示

页面内容和内容片段有助于您更加轻松地在 Power Pages 设计工作室中输入 Liquid 内容，从而练习使用 Liquid。 随着学习内容的深入，您试用任何 Liquid 示例片段，方法是试用 Power Pages 设计工作室或 Visual Studio Code 将代码直接复制粘贴到页面中。

输出

输出语句是一组包含表达式的双括号。 呈现输出时替换为表达式的值。 表达式可以包括 Liquid 对象及其属性和变量。 以下示例演示了一个简单的输出语句：

Hello {{ user.firstname }} from {{ 'Power Pages' }}

假设用户的名字为 Doug，此输出语句将生成以下结果：

Hello Doug from Power Pages

筛选器

输出标记可以采用筛选器，它会修改输出语句的结果。 可以在输出表达式后添加管道字符 (|)、筛选器名称和冒号 (:) 后的可选参数，从而添加筛选器。

Hello {{ user.firstname | upcase }} from {{ 'Power Pages' }}. The date is {{ 'now' | date: 'MMMM d yyyy' }}

此筛选器语句将生成以下结果：

Hello DOUG from Power Pages. 日期为 2023 年 5 月 25 日。

标记

标记可用于模板中的逻辑和控制流，例如（示例中也添加了 HTML）：

{% assign product = 'Power Pages' %}

<p>
    {% if user %}
        Hello, {{ user.firstname | upcase }}, from <strong>{{ product }}</strong>.
    {% else %}
        Greetings, <em>visitor</em>, from <strong>{{ product }}</strong>!
    {% endif %}
</p>

<p>The time is {{ 'now' | date: 'g' }}</p>

在此片段中，assign 标记可创建一个新变量，if... else 构造生成的输出取决于是否已定义用户（即是否有已登录的网站访问者）。 匿名用户的输出如下：

Greetings, visitor, from Power Pages!

现在是 2023 年 5 月 24 日上午 11:33

Liquid 包含多个内置对象和标记，因此功能丰富且使用灵活。 由 Power Pages 实现的 Liquid 扩展可为您带来切实的益处。