PbootCMS 调用标题和摘要描述字数限制方法

一、功能需求

在 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（精准截取）三类参数，可灵活实现标题、摘要的字数限制。合理配置不仅能保障页面排版美观，还能提升用户浏览体验，适配不同场景的内容展示需求。