3.1 Filters:abs,返回一个数字的绝对值
abs 返回一个数字的绝对值。 输入 {{ -17 | abs }} 输出 17 输入 {{ 4 | abs }} 输出 4 如果组成字符串的各个字符全是数字,abs 也能够对此字符串求绝对值。 输入 {{ "-19.86" | abs }} 输出 19.86
abs 返回一个数字的绝对值。 输入 {{ -17 | abs }} 输出 17 输入 {{ 4 | abs }} 输出 4 如果组成字符串的各个字符全是数字,abs 也能够对此字符串求绝对值。 输入 {{ "-19.86" | abs }} 输出 19.86
append 将两个字符串拼接起来并返回拼接之后的值。 输入 {{ "/my/fancy/url" | append: ".html" }} 输出 /my/fancy/url.html append 同样能够作用于变量: 输入 {% assign filename = "/index.html" %} {{ "website.com" | append: filename }} 输出 website.com/index.html
at_least 将数字限制在最小值。 输入 {{ 4 | at_least: 5 }} 输出 5 输入 {{ 4 | at_least: 3 }} 输出 4
at_most 将数字限制在最大值。 输入 {{ 4 | at_most: 5 }} 输出 4 输入 {{ 4 | at_most: 3 }} 输出 3
capitalize 将字符串首字母转为大写。 输入 {{ "title" | capitalize }} 输出 Title capitalize 只把字符串的首字母转为大写,其他字符不受影响: 输入 {{ "my great title" | capitalize }} 输出 My great title
ceil 将一个浮点数向上取整并返回一个最接近的整数。在 ceil 过滤器执行之前 Liquid 会先尝试将输入转换为数字格式。 输入 {{ 1.2 | ceil }} 输出 2 输入 {{ 2.0 | ceil }} 输出 2 输入 {{ 183.357 | ceil }} 输出 184 以下实例所用输入是字符串: 输入 {{ "3.5" | ceil }} 输出 4
compact 删除数组中的所有 nil 值。 例如,假定整个网站所有内容页面作为一个数组保存在 site.pages 变量中,其中某些页面被设置了 category 属性用于指定该页面的内容分类。如果我们利用 map 过滤器将所有页面的 category 属性保存到一个数组中,就会出现如果某个页面没有 category 属性,其在数组中的值就会是 nil。 输入 {...
连接多个数组。生成的数组包含输入数组中的所有项目。 Input {% assign fruits = "apples, oranges, peaches" | split: ", " %} {% assign vegetables = "carrots, turnips, potatoes" | split: ", " %} {% assign everything = fruits | concat: vegetables %} {% for item in everything %} - {{ item }} {% endfor %} Outp...
date 将时间戳(timestamp)转换为另一种日期格式。格式化语法与 strftime 一致。输入格式与 Ruby 中的 Time.parse 一致。 输入 {{ article.published_at | date: "%a, %b %d, %y" }} 输出 Fri, Jul 17, 15 输入 {{ article.published_at | date: "%Y" }} 输出 2015 date 能够作用于包含良好格式化的日期字符串: 输入 {{ "Ma...
default 指定一个默认值,以防预期的值不存在。如果左侧的值为 nil、false 或空,default 将输出此默认值。 如下实例中,product_price 并未被定义,因此将输出默认值。 输入 {{ product_price | default: 2.99 }} 输出 2.99 如下实例中,product_price 已被定义,不再输出默认值。 输入 {% assign product_price = 4.99 %} {...
divided_by 将两个数相除。 如果除数(divisor)为整数,则将相除之后得到的结果向下取整得到最接近的整数(也就是对应 floor 的功能)。 输入 {{ 16 | divided_by: 4 }} 输出 4 输入 {{ 5 | divided_by: 3 }} 输出 1 控制舍入 divided_by 返回的结果于除数是同一数据类型的,也就是说,如果除数是整数,返回的结果也是整数;...
downcase 用于将字符串中的各个字符转换为小写形式。对于已经是小写形式的字符串没有任何影响。 输入 {{ "Parker Moore" | downcase }} 输出 parker moore 输入 {{ "apple" | downcase }} 输出 apple
escape 对字符串转义操作就是将字符串中的某些字符替换为转义序列(escape sequence),这样整个字符串就能够用于 URL 了。如果字符串不需要转义则不会对字符串做任何操作。 输入 {{ "Have you read 'James & the Giant Peach'?" | escape }} 输出 Have you read 'James & the Giant Peach'? 输...
escape_once 转义一个字符串并且不修改已经转义过的实体(entities)。对于无须转义的字符串不做任何修改。 输入 {{ "1 < 2 & 3" | escape_once }} 输出 1 < 2 & 3 输入 {{ "1 < 2 & 3" | escape_once }} 输出 1 < 2 & 3
first 返回数组的第一项。 输入 {% assign my_array = "apples, oranges, peaches, plums" | split: ", " %} {{ my_array.first }} 输出 apples 输入 {% assign my_array = "zebra, octopus, giraffe, tiger" | split: ", " %} {{ my_array.first }} 输出 zebra
floor 将一个浮点数通过舍弃小数部分得到最近的整数。在 floor 过滤器执行之前 Liquid 会先尝试将输入转换为数字格式。 输入 {{ 1.2 | floor }} 输出 1 输入 {{ 2.0 | floor }} 输出 2 输入 {{ 183.357 | floor }} 输出 183 以下实例所用输入是字符串: 输入 {{ "3.5" | floor }} 输出 3
join 将数组中的各个字符串合并为一个字符串,并将 split 参数作为字符串之间的分隔符。 输入 {% assign beatles = "John, Paul, George, Ringo" | split: ", " %} {{ beatles | join: " and " }} 输出 John and Paul and George and Ringo
last 返回数组中的最后一项。 输入 {% assign my_array = "apples, oranges, peaches, plums" | split: ", " %} {{ my_array.last }} 输出 plums 输入 {% assign my_array = "zebra, octopus, giraffe, tiger" | split: ", " %} {{ my_array.last }} 输出 tiger
lstrip 删除字符串左侧的所有空白符(制表符、空格和换行符)。字符串中间的所有空白符不受影响。 输入 {{ " So much room for activities! " | lstrip }} 输出 So much room for activities!
map 从对象(object)中提取指定名称的属性的值,并用这些值构建一个数组。 以下实例中,假定 site.pages 包含了整个网站的元数据信息。利用 assign 和 map 过滤器创建一个变量,此变量只包含 site.pages 对象中 category 属性对应的所有值。 输入 {% assign all_categories = site.pages | map: "category" %} {% for item i...
minus 从一个数中减去另一个数。 输入 {{ 4 | minus: 2 }} 输出 2 输入 {{ 16 | minus: 4 }} 输出 12 输入 {{ 183.357 | minus: 12 }} 输出 171.357
modulo 返回除法运算的余数。 输入 {{ 3 | modulo: 2 }} 输出 1 输入 {{ 24 | modulo: 7 }} 输出 3 输入 {{ 183.357 | modulo: 12 }} 输出 3.357
newline_to_br 将所有换行符(n) 替换为 HTML 的 (<br>) 标签。 输入 {% capture string_with_newlines %} Hello there {% endcapture %} {{ string_with_newlines | newline_to_br }} 输出 <br /> Hello<br /> there<br />
plus 两个数相加。 输入 {{ 4 | plus: 2 }} 输出 6 输入 {{ 16 | plus: 4 }} 输出 20 输入 {{ 183.357 | plus: 12 }} 输出 195.357
prepend 在一个字符串前面附加另一个字符串。 输入 {{ "apples, oranges, and bananas" | prepend: "Some fruit: " }} 输出 Some fruit: apples, oranges, and bananas prepend 也能作用于变量: 输入 {% assign url = "example.com" %} {{ "/index.html" | prepend: url }} 输出 example.com/index.html
remove 从一个字符串中删除所有出现的另一个子字符串。 输入 {{ "I strained to see the train through the rain" | remove: "rain" }} 输出 I sted to see the t through the
remove_first 从一个字符串中仅仅删除第一次出现的另一个子字符串。 输入 {{ "I strained to see the train through the rain" | remove_first: "rain" }} 输出 I sted to see the train through the rain
replace 将参数中给出的第一个参数全部替换为第二个参数。 输入 {{ "Take my protein pills and put my helmet on" | replace: "my", "your" }} 输出 Take your protein pills and put your helmet on
replace_first 将字符串中出现的第一个参数替换为第二个参数。 输入 {% assign my_string = "Take my protein pills and put my helmet on" %} {{ my_string | replace_first: "my", "your" }} 输出 Take your protein pills and put my helmet on
reverse 将数组中的所有项的顺序反转。reverse 不能操作字符串。 输入 {% assign my_array = "apples, oranges, peaches, plums" | split: ", " %} {{ my_array | reverse | join: ", " }} 输出 plums, peaches, oranges, apples reverse 不能直接应用到字符串上,但是你可以先将字符串分割成字符数组,然后再将数组反转,最...
round 将浮点数舍入到最近的整数,或者,如果传入的参数是一个数值的话,将浮点数舍入到参数指定的小数位。 输入 {{ 1.2 | round }} 输出 1 输入 {{ 2.7 | round }} 输出 3 输入 {{ 183.357 | round: 2 }} 输出 183.36
rstrip 将字符串右侧的所有空白字符(制表符 - tab、空格符 - space 和 回车符 - newline)删除。 输入 {{ " So much room for activities! " | rstrip }} 输出 So much room for activities!
size 返回字符串中所包含的字符数或者数组中所包含的条目数量。size 还支持“点标记”(例如 {{ my_string.size }})。这种用法便于你在标签(tag)中使用 size 过滤器,例如条件判断标签(tag)。 输入 {{ "Ground control to Major Tom." | size }} 输出 28 输入 {% assign my_array = "apples, oranges, peaches, plums" | s...
slice 只传入一个参数时将返回此参数作为下标所对应的单个字符。第二个参数是可选的,用于指定返回的子字符串的长度。 String indices are numbered starting from 0. 输入 {{ "Liquid" | slice: 0 }} 输出 L 输入 {{ "Liquid" | slice: 2 }} 输出 q 输入 {{ "Liquid" | slice: 2, 5 }} 输出 quid If the first parameter is ...
sort 对数组中的所有进行排序。排序后的数组是按照区分大小写的顺序排列的。 输入 {% assign my_array = "zebra, octopus, giraffe, Sally Snake" | split: ", " %} {{ my_array | sort | join: ", " }} 输出 Sally Snake, giraffe, octopus, zebra
sort_natural 对数组进行排序,并且大小写无关。 输入 {% assign my_array = "zebra, octopus, giraffe, Sally Snake" | split: ", " %} {{ my_array | sort_natural | join: ", " }} 输出 giraffe, octopus, Sally Snake, zebra
split 根据参数传入的分隔符将字符串分解为数组。split 通常被用于将以逗号为分隔符的字符串转换为数组。 输入 {% assign beatles = "John, Paul, George, Ringo" | split: ", " %} {% for member in beatles %} {{ member }} {% endfor %} 输出 John Paul George Ringo
strip 删除字符串左右两侧的所有空白符号(包括制表符、空格、换行符)。对于字符串中间的空白符不做任何处理。 Input {{ " So much room for activities! " | strip }} Output So much room for activities!
strip_html 从字符串中删除所有 HTML 标签。 输入 {{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }} 输出 Have you read Ulysses?
strip_newlines 从字符串中删除所有换行字符(newline character)。 输入 {% capture string_with_newlines %} Hello there {% endcapture %} {{ string_with_newlines | strip_newlines }} 输出 Hellothere
times 将一个数乘以另一个数。 输入 {{ 3 | times: 2 }} 输出 6 输入 {{ 24 | times: 7 }} 输出 168 输入 {{ 183.357 | times: 12 }} 输出 2200.284
truncate truncate 将字符串截短为指定的字符个数。如果指定的字符数量小于字符串的长度,则会在字符串末尾添加一个省略号(…) 并将此省略号计入字符个数中。 输入 {{ "Ground control to Major Tom." | truncate: 20 }} 输出 Ground control to... 自定义省略号 truncate 还支持第二个可选参数,用于指定一个字符序列,此字符...
truncatewords 将字符串截短为指定的单词个数。如果指定的单词数量小于字符串中包含的单词个数,则会在字符串末尾添加一个省略号(…)。 输入 {{ "Ground control to Major Tom." | truncatewords: 3 }} 输出 Ground control to... 自定义省略号 truncatewords 还支持第二个可选参数,用于指定一个字符序列,此字符序列将被添加...
uniq 删除数组中的所有冗余项。 输入 {% assign my_array = "ants, bugs, bees, bugs, ants" | split: ", " %} {{ my_array | uniq | join: ", " }} 输出 ants, bugs, bees
upcase 将字符串中的每个字符都转换为大写形式。对于已经全是大写的字符串不做任何操作。 输入 {{ "Parker Moore" | upcase }} 输出 PARKER MOORE 输入 {{ "APPLE" | upcase }} 输出 APPLE
url_decode 对于作为 URL 进行编码或通过 url_encode 编码的字符串进行解码。 输入 {{ "%27Stop%21%27+said+Fred" | url_decode }} 输出 'Stop!' said Fred
url_encode 将字符串中非 URL 安全的字符转换为百分号编码(percent-encoded)的字符。 输入 {{ "john@liquid.com" | url_encode }} 输出 john%40liquid.com 输入 {{ "Tetsuro Takara" | url_encode }} 输出 Tetsuro+Takara
© Copyright 2023 深圳蓝晒科技有限公司. 粤ICP备2023054553号-1