# substr字符(標題)截取標簽 ## 字符截取標簽 可以對標題、描述等字段進行截取。 ## 格式 截取文章標題，保留10個字，超出的...顯示 ``` <pre class="calibre16">``` <span class="token1">{</span>hkcms<span class="token1">:</span>substr name<span class="token">=</span><span class="token4">"$item.title"</span> len<span class="token">=</span><span class="token4">"10"</span> dot<span class="token">=</span><span class="token4">"..."</span> <span class="token1">}</span> ``` ``` 截取描述，保留10個字，超出的...顯示 ``` <pre class="calibre16">``` <span class="token1">{</span>hkcms<span class="token1">:</span>substr name<span class="token">=</span><span class="token4">"$item.description"</span> len<span class="token">=</span><span class="token4">"10"</span> dot<span class="token">=</span><span class="token4">"...."</span> <span class="token1">}</span> ``` ``` ## 參數 參數名稱可選值默認值是否必填支持版本說明name--是無限制傳入待截取的變量，可以在列表循環、詳情頁使用len--是無限制長度、保留字數dot-...否無限制超出的標題尾部拼接字符lang--否v2.2.4.221230特定語言下有效，可用于只對中文、或英文設置不同長度的字符截取## 示例 `name` 待截取的字符變量，如下獲取內容列表時，截取標題。 ``` <pre class="calibre16">``` <span class="token1">{</span>hkcms<span class="token1">:</span>content model<span class="token">=</span><span class="token4">"6"</span> num<span class="token">=</span><span class="token4">"4"</span><span class="token1">}</span> <span class="token"><</span>div class<span class="token">=</span><span class="token4">"card-body"</span><span class="token">></span> <span class="token"><</span>h5 class<span class="token">=</span><span class="token4">"text-truncate"</span><span class="token">></span> 截取標題：保留<span class="token3">6</span>個字，后面拼接省略號<span class="token1">.</span><span class="token1">.</span><span class="token1">.</span><span class="token1">.</span> <span class="token1">{</span>hkcms<span class="token1">:</span>substr name<span class="token">=</span><span class="token4">"$item.title"</span> len<span class="token">=</span><span class="token4">"6"</span> dot<span class="token">=</span><span class="token4">"...."</span> <span class="token1">}</span> <span class="token"><</span><span class="token">/</span>h5<span class="token">></span> <span class="token"><</span><span class="token">/</span>div<span class="token">></span> <span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span> ``` ``` `lang` 屬性，用于限制指定的語言下截取的字符長度。如下，對英文截取12個字符，中文截取8個字符，多語言情況下是配合一起使用，每個語言需要寫一個字符截取。 ``` <pre class="calibre20">``` <span class="token"><</span>a <span class="token">></span><span class="token1">{</span>hkcms<span class="token1">:</span>substr name<span class="token">=</span><span class="token4">"$item.title"</span> len<span class="token">=</span><span class="token4">"12"</span> dot<span class="token">=</span><span class="token4">"..."</span> lang<span class="token">=</span><span class="token4">"en"</span><span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span> <span class="token"><</span>a <span class="token">></span><span class="token1">{</span>hkcms<span class="token1">:</span>substr name<span class="token">=</span><span class="token4">"$item.title"</span> len<span class="token">=</span><span class="token4">"8"</span> dot<span class="token">=</span><span class="token4">"..."</span> lang<span class="token">=</span><span class="token4">"zh-cn"</span><span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span> ``` ```