## 字符截取标签 可以对标题、描述等字段进行截取。 ## 格式 截取文章标题，保留10个字，超出的...显示 ~~~ {hkcms:substr name="$item.title" len="10" dot="..." } ~~~ 截取描述，保留10个字，超出的...显示 ~~~ {hkcms:substr name="$item.description" len="10" dot="...." } ~~~ ## 参数 | 参数名称 | 可选值 | 默认值 | 是否必填 | 支持版本|说明 | | --- | --- | --- | --- | --- | --- | | name | - | - | 是| 无限制 | 传入待截取的变量，可以在列表循环、详情页使用 | | len | - | - | 是 | 无限制 |长度、保留字数 | | dot | - | ... | 否 | 无限制 |超出的标题尾部拼接字符 | | lang | - | - | 否 | v2.2.4.221230| 特定语言下有效，可用于只对中文、或英文设置不同长度的字符截取 | ## 示例 `name` 待截取的字符变量，如下获取内容列表时，截取标题。 ``` {hkcms:content model="6" num="4"} <div class="card-body"> <h5 class="text-truncate"> 截取标题：保留6个字，后面拼接省略号.... {hkcms:substr name="$item.title" len="6" dot="...." } </h5> </div> {/hkcms:content} ``` `lang` 属性，用于限制指定的语言下截取的字符长度。如下，对英文截取12个字符，中文截取8个字符，多语言情况下是配合一起使用，每个语言需要写一个字符截取。 ~~~ <a >{hkcms:substr name="$item.title" len="12" dot="..." lang="en"}</a> <a >{hkcms:substr name="$item.title" len="8" dot="..." lang="zh-cn"}</a> ~~~