内容裁剪 Clamp

Clamp 提供四种裁剪组件，保留既有属性、事件、插槽与实例方法，不增加包装 DOM。通过全量安装可使用 sd-line-clamp、sd-rich-line-clamp、sd-inline-clamp 和 sd-wrap-clamp；按需引入时使用 LineClamp、RichLineClamp、InlineClamp 和 WrapClamp。

纯文本多行裁剪

LineClamp 根据真实布局裁剪纯文本，可通过 max-lines 或 max-height 约束空间。

单行字符串

InlineClamp 适合文件名等需要保留固定前后缀的字符串。

受控展开

LineClamp、RichLineClamp 和 WrapClamp 都支持 v-model:expanded，并向 before、after 插槽提供控制方法与裁剪状态。

富文本与原子项

RichLineClamp 仅用于已经清洗的可信 HTML；WrapClamp 保证标签、筛选项等原子项不会从中间截断。

API

四个组件保持与此前封装的 vue-clamp 1.7.2 相同的 Props、Events、Slots、实例方法与 TypeScript 类型；可继续参考 对应上游 API 文档。

需要渲染不可信富文本时，必须先在业务侧完成清洗，再传给 RichLineClamp 的 html 属性。

实现说明

• RichLineClamp 在根元素内常驻一个 aria-hidden 的隐藏测量探针（含全文副本）。对根元素读取 textContent / innerText 会得到双份文本，需要精确取值时请选中 [data-part="body"]。
• LineClamp 与 RichLineClamp 只接受字符串（text / html）作为测量内容，没有默认插槽。Ellipsis 会继续渲染原始 Vue 插槽，组件、事件、属性与 scoped 样式保持可用；同时把实际 DOM 的 HTML 副本交给隐藏的 RichLineClamp 计算裁剪状态。测量副本带有 aria-hidden，不会参与交互，但 DOM 查询可能匹配到同名隐藏节点；测试和取值应选中可见内容或明确的 data-part。