一、功能需求

在 PbootCMS 模板開發中，需對文章標題、摘要描述進行字數限制，避免因內容過長導致頁面排版混亂，保障頁面整潔性與用戶體驗（如文章列表頁的標題 / 摘要展示）。

二、長度截取方法

1. len與lencn參數（核心區別）

• len參數：按 “字符數量” 截取，英文、中文字符均算 1 個字符。
  示例：[list:title len=60]（截取標題前 60 個字符）。

• lencn參數：解決中英文長度不統一問題，1 個英文字符算 0.5 個字符，1 個中文字符算 1 個字符。
  示例：[list:title lencn=60]（兼顧中英文時，更精準控制顯示長度）。

2. 省略號自定義（V1.3.5 + 版本支持）

通過more參數設置截取后的省略內容，若配置more則不顯示默認省略號。
示例：[list:description len=100 more='...查看更多']（截取 100 字符后，末尾顯示 “... 查看更多”）。

三、substr截取方法（字符串精準截取）

substr用于截取字符串片段，規則：

• 傳 2 個數字：substr=x-y（從第x位開始，截取y個字符）。

• 傳 1 個數字：substr=x（從第x位開始，截取后續所有內容）。

示例：

• [list:title substr=0-20]（截取標題前 20 個字符）。

• [list:title substr=5]（從第 5 位開始，截取標題剩余全部內容）。

四、示例代碼解析

以下為模板中調用標題、摘要并限制字數的完整示例：

{pboot:list scode=[nav:scode] num=3 order=sorting start=2}
  <a href="[list:link]" title="[list:title]">
    <strong>[list:date style=d]</strong>[list:date style=Y-m]
    <h4>[list:title]</h4>
    <p>[list:description lencn=60]</p>
  </a>
{/pboot:list}

代碼拆解

• 列表調用基礎配置：scode=[nav:scode]（調用當前導航欄文章）、num=3（每頁顯示 3 篇）、order=sorting（按排序字段排列）、start=2（從第 2 篇文章開始展示）。

• 日期格式化：[list:date style=d]（顯示日期）、[list:date style=Y-m]（顯示 “年 - 月”）。

• 摘要字數限制：[list:description lencn=60]（摘要按中英文適配規則，截取 60 字符長度）。

五、總結

通過len/lencn（長度控制）、more（省略號自定義）、substr（精準截?。┤悈?，可靈活實現標題、摘要的字數限制。合理配置不僅能保障頁面排版美觀，還能提升用戶瀏覽體驗，適配不同場景的內容展示需求。