Tinyliquid 正在参加 2020 年度 OSC 中国开源项目评选,请投票支持!
Tinyliquid 在 2020 年度 OSC 中国开源项目评选 中已获得 {{ projectVoteCount }} 票,请投票支持!
投票让它出道
已投票
Tinyliquid 获得 2020 年度 OSC 中国开源项目评选「最佳人气项目」 !
Tinyliquid 获得 2020 年度 OSC 中国开源项目评选「最佳人气项目」「最积极运营项目」 !
Tinyliquid 获得 2020 年度 OSC 中国开源项目评选「最积极运营项目」 !
授权协议 MIT
开发语言 JavaScript
操作系统 跨平台
软件类型 开源软件
所属分类 程序开发模板引擎
开源组织
地区 国产
提 交 者 程序员老雷
适用人群 未知
收录时间 2013-02-19

软件简介

TinyLiquid是一个基于JavaScript,兼容Liquid模板语法的的模板引擎。 其具有以下特点:

  • 支持异步本地和异步过滤器

  • 轻松添加自定义标签和自定义过滤器

  • 几乎完全支持液体语法

  • 支持Express 3.x框架

  • 高测试覆盖率(92%覆盖率)

下载 & 安装

目前最新版为v0.0.9,可通过以下方式来获取TinyLiquid模块:

  • 通过NPM安装:npm install tinyliquid

  • 通过git下载:git clone git://github.com/leizongmin/tinyliquid.git

  • 浏览器端使用:

  • Express 3.x中使用:模块express-liquid

Liquid模板语法

Liquid是一个比较优秀的轻量级的模版语言。详见:Liquid官网

基础

Liquid有两种形式的标签,即输出标签逻辑标签。这两种标签的区别在于:

输出标签:用于处理模版输出值,使用{{}}包围,如下: {{ product.title }}

逻辑标签:用于处理模版逻辑,使用{%%}包围,如下: {% if product.price > 100 %}

输出标签

如下面例子: 你好 {{name}}
你好 {{user.name}} 你好 {{ 'shopqi' }}

过滤器

输出标签的内容可以通过过滤器来进行格式化操作。例如,我们将‘shop’的转化成大写输出,可使用如下形式的标签 {{ 'shop' | upcase}}

逻辑标签

逻辑标签用于处理模版中的逻辑关系,ShopQi支持如下标签

if/else/unless

用于判断条件,参数为boolean值:

{% if user %}
  Hi {{ user.name }}
{% endif %}

{% if user.name == 'tobi' %}
  hi tobi
{% endif %}

{% if user.name != 'tobi' %} 
  hi non-tobi
{% endif %}

{% unless user.name == 'tobi' %} 
  hi non-tobi
{% endunless %}

{% if user.name == 'tobi' or user.name == 'marc' %} 
  hi marc or tobi
{% endif %}

{% if user.name == 'tobi' and user.last_name == 'scottish' %} 
  hi tobi scottish
{% endif %}

{% if user.name contains 'tobi' %} 
  hi tobias
{% endif %}

{% if user.creditcard == nil %}
   poor sob
{% endif %}

{% if user.payments == empty %}
   you haven't paid yet! 
{% endif %}

{% if user.age > 18 %}
   Login here
{% else %}
   Sorry, you are too young
{% endif %}

{% unless user.age > 18 %}
  Sorry, you are too young
{% else %}
  Login here
{% endunless %}

case语句块

如果一个情况存在多个分支的情况,可使用case来处理:

{% case condition %} 
  {% when 1 %} 
    hit 1 
  {% when 2 %} 
    hit 2 
  {% else %} 
    hit else
{% endcase %}

cycle标签

通常情况下,我们有时候需要循环交替的执行某些任务。Liquid支持这种周期性的执行任务的标签,如下:

{% cycle 'one', 'two', 'three' %}
 
{% cycle 'one', 'two', 'three' %}
 
{% cycle 'one', 'two', 'three' %}
 
{% cycle 'one', 'two', 'three' %} 

结果为:

one
two
three
one

如果,我们使用

for标签

liquid支持集合数据循环,如:

{%for item in collection%}
{{item}}
{%endfor%}

同样还支持如下一些辅助方法: forloop.length # => 整个循环的总次数 forloop.index # => 当前循环的下标 forloop.index0 # => 当前循环的下标(从0开始算) forloop.rindex # => 计算还剩下多少次数未执行 forloop.rindex0 # => 计算还剩下多少次数未执行(从0开始计算) forloop.first # => 是否是集合的第一次循环 forloop.last # => 是否是集合的最后一次循环

for循环还支持一些属性limit,offset,其中,limit用于限制集合循环次数,offset用于设置开始的下标,如:

# array = [1,2,3,4,5,6]
  {% for item in array limit:2 offset:2 %} 
    {{ item }}
  {% endfor %} 
  # results in 3,4 
同样,for里面还支持范围的定义,即..用来取得范围,如:
  # if item.quantity is 4...
  {% for i in (1..item.quantity) %}
    {{ i }}
  {% endfor %}
  # results in 1,2,3,4

Tables

Liquid同样支持创建表格,创建行和列

{% tablerow item in items cols: 3 limit: 12 %}
    {{ item.variable }}
  {% endtablerow %}

变量赋值assign

当我们需要为变量赋值时,我们可以使用assign来进行定义我们需要的变量:

{% assign name = 'freestyle' %}
{% for t in collections.tags %}
{% if t == name %}
  

Freestyle!

{% endif %} {% endfor %}

展开阅读全文

代码

的 Gitee 指数为
超过 的项目

评论 (0)

加载中
更多评论
暂无内容
暂无内容
暂无内容
0 评论
7 收藏
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部