1.2. 如何使用 Liquid

在 3scale 开发人员门户中，您可以访问三种类型的 Liquid 标记：

Liquid drops、标签和过滤器与 How to use liquids 中提到的逻辑和输出标签类似。

Liquid drops 是最基本的结构，您经常会使用它们。它们提供对系统中存储的某些值的访问权限，如用户名称和应用的标识符。解释器处理它们的方式与任何其他输出标签相同。

另一方面，Liquid 标签是一种逻辑标签，可以呈现或访问系统的某些部分进行进一步自定义，例如，呈现布局中的内容或自定义电子邮件模板。

通过过滤器，可以选择从丢弃、转换值和按某些键分组的结果。有一组标准的 liquid 过滤器，您可以在 Shopify 网站 中找到，以及一组特殊的 3scale 内部过滤器，这些过滤器列在liquid 参考部分 中列出的。

该上下文描述了可在当前页面中使用哪些变量(drops)。基本集包括以下变量：

除了电子邮件模板外，这些变量可在整个开发人员门户的每个页面上提供。但是，大多数内置页面都将具有一些额外的变量。例如，编辑用户表单将公开一个 user 变量（而不是当前用户 - 在编辑用户页面中，用户的身份已经已知）。要检查当前页面中有哪些变量可用，有一个特殊的标签：{% debug:help %}。它将添加所有可用的顶级变量的列表，以用作页面源中的注释。

该上下文的直接结果是颠覆性下降被组织到层次结构中。可用的一组变量列出了可用的顶级丢弃。使用它们，您可以更深入地访问层次结构中的元素。例如，如果您想要显示已登录用户的用户名，则需要编写 {{ current_user.username }}。

显示较低级别丢弃稍微复杂一些。假定您要为用户显示唯一的应用的名称。查看参考指南，您可以看到方法 应用 是帐户丢弃的一部分。这意味着应用是单一应用标签的数组。如果您的用户被允许有多个应用程序，则必须使用逻辑标签迭代应用程序。否则，您可以引用帐户上的第一个（和唯一的）应用程序。要显示的代码如下所示： {{ current_account.applications.first.name }}。