truncate

把文本截断到字符数上限。

语法

{{ value | truncate:100 }}
{{ value | truncate:(100, "...") }}

用法

• 必填的第一个参数是非负的字符数上限。
• 后缀默认为 …。传入第二个参数可以替换它，或传 "" 以省略它。
• 后缀计入字符数上限；当它比上限还长时会被裁掉。
• 诸如 emoji 这样的 Unicode 字素簇按一个字符计算。
• 对于数组和对象（包括来自其他过滤器、已序列化的集合），其中的字符串取值会被递归格式化，而键和非字符串取值保持不变。

示例

默认后缀

Data

{
  "text": "A concise introduction to Knap"
}

Template

{{ text | truncate:10 }}

Output

A concise…

自定义后缀

Data

{
  "text": "A concise introduction"
}

Template

{{ text | truncate:(12, "...") }}

Output

A concise...

无后缀

Data

{
  "text": "A concise introduction"
}

Template

{{ text | truncate:(9, "") }}

Output

A concise

相关过滤器

• truncatewords