特殊语法 - 友好速搭 -- 开发文档

友好速搭

模板引擎
简介 Liquid 基础语法 Liquid 内置方法 友好速搭主题对象

特殊语法

本节包含以下内容:


comment

用于代码注释,示例如下:

输入:

感谢使用{% comment %}{% endcomment %}友好速搭。

输出:

感谢使用友好速搭。

include

从主题文件的 小部件/Snippets 目录中,加载文件。示例如下:

{% include 'product_grid_item' %}

当 Snippet 文件被加载有,里面的代码,可以访问当前页面的变量。

include的参数

with with参数,可以将当前页面的变量值,传递到 Snippet 文件,变量名就是 Snippet 的文件名。 例如,有个名为 color.html 的 Snippet 文件,内容如下:

color: '{{ color }}'
shape: '{{ shape }}'

在 Template 文件 index.html 中,使用include引入 color.html 文件:

输入:

{% assign shape = '' %}
{% include 'color' %}
{% include 'color' with '' %}
{% include 'color' with '' %}
{% assign shape = '' %}
{% include 'color' with '' %}

输出:

color: shape: '圆形'
color: '红色' shape: '圆形'
color: '蓝色' shape: '圆形'
color: '红色' shape: '方形'

layout

在主题文件中,默认使用名为 theme.html 的布局文件,可以通过layout来指定使用其它布局文件:

{% layout 'newlayout' %}

如果不想在主题文件中,引入布局文件,可以使用none

{% layout 'none' %}

dynamic_layout

在主题文件中,可以通过dynamic_layout来为PC端和移动端指定不同的布局文件:

{% dynamic_layout 'theme' | 'mobile' %}

默认使用名为 theme.html 的布局文件,如果是移动设备,将使用名为 mobile.html 的布局文件。

raw

可以将 Liquid 代码,以文本形式输出,而不会执行。示例如下:

输入:

{% raw %}{{ 5 | plus: 6 }}{% endraw %} 等于 11。

输出:

{{ 5 | plus: 6 }} 等于 11。

raw 的另外一个用法

使用 Liquid 引擎处理相关 JS 文件时,可能会因为 {{ }}等符号被处理,导致 JS 文件原有逻辑被改变和破坏。这个时候我们需要保持原文(raw)。有以下两种方法:

  1. 打开 JS 文件, 在顶部输入{% raw %}、底部输入{% endraw %}
  2. 修改 JS 文件名,在后缀名之前加raw,例:abc.js改名为abc.raw.jsjq.min.js改名为jq.min.raw.js

CSS 文件亦遵循此规则。

免费领取15天试用
立即注册
联系客服
微信咨询
微信二维码

领取免费试用资格

姓名 *

电话 *

公司名称

所在地区

意向产品

提交

提交成功

你好, XXX女士/先生 ,你的需求已提交成功,后续会有专门的客户经理与你电话联系。谢谢!