## 字符截取標簽 可以對標題、描述等字段進行截取。 ## 格式 截取文章標題，保留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> ~~~