本文详解在 Vue 3（Composition API）中正确判断文本是否因 -webkit-line-clamp 而发生截断的完整方案，涵盖 DOM 引用、计算样式获取、动态监听及响应式更新，避免常见引用错误与 CSS 属性读取陷阱。
本文详解在 vue 3（composition api）中正确判断文本是否因 `-webkit-line-clamp` 而发生截断的完整方案，涵盖 dom 引用、计算样式获取、动态监听及响应式更新，避免常见引用错误与 css 属性读取陷阱。
在 Vue 开发中，为长文本实现「展开/收起」交互时，常需动态判断内容是否已被 line-clamp 截断，从而决定是否显示操作按钮。但直接调用 element.css() 或在 computed 中访问未挂载 DOM 元素，会导致 undefined 错误或计算失效——核心问题在于：-webkit-line-clamp 是渲染后生效的 CSS 属性，必须通过 window.getComputedStyle() 获取其计算值，且 DOM 引用必须确保已挂载。
以下为推荐的 Vue 3 Composition API 实现方式：
✅ 正确初始化 DOM 引用：
import { ref, computed, watch, onMounted } from 'vue';
const isExpanded = ref(true);
const information = ref<HTMLElement | null>(null); // 类型安全：明确指向 HTMLElement
const isTextTruncated = ref(false);
const toggleCta = computed(() => isExpanded.value ? '展开' : '收起');✅ 使用 watch 监听 DOM 引用变化（推荐），并结合 onMounted 确保首次校验：
立即学习“前端免费学习笔记（深入）”；
// 首次挂载时主动检查
onMounted(() => {
checkTruncation();
});
// 监听 DOM 引用变化（适用于内容异步加载、响应式数据更新等场景）
watch(information, () => {
checkTruncation();
});
function checkTruncation() {
const el = information.value;
if (!el) return;
const computedStyle = window.getComputedStyle(el);
const lineClampStr = computedStyle.getPropertyValue('-webkit-line-clamp');
const lineClamp = parseInt(lineClampStr, 10);
// ⚠️ 注意：getClientRects() 返回的是“可见行框”数量，但需确保元素已渲染且非 display: none
const lineCount = el.getClientRects().length;
// 安全比较：仅当 lineClamp 有效（> 0）且行数超出时才判定为截断
isTextTruncated.value = Number.isInteger(lineClamp) && lineClamp > 0 && lineCount > lineClamp;
}✅ 模板中正确绑定：
<div
ref="information"
:class="{ truncate: !isExpanded.value }"
aria-expanded="false"
>
{{ data?.information }}
</div>
<span
v-if="isTextTruncated"
@click="isExpanded = !isExpanded"
class="text-blue-600 cursor-pointer hover:underline"
role="button"
tabindex="0"
>
{{ toggleCta }}
</span>✅ 样式保持不变（关键属性不可省略）：
.truncate {
overflow: hidden;
text-overflow: ellipsis;
display: -webkit-box;
-webkit-line-clamp: 3; /* 可动态修改，checkTruncation 会自动适配 */
-webkit-box-orient: vertical;
}? 重要注意事项：
- getClientRects() 在元素未渲染（如 v-if 切换中）、display: none 或字体未加载完成时可能返回 0，建议搭配 onMounted 和 nextTick 做容错；
- Safari 和 Chrome 支持 -webkit-line-clamp，Firefox 需使用 line-clamp（标准属性），生产环境建议添加 @supports 回退；
- 若文本内容动态变更（如搜索过滤），需在数据更新后手动触发 checkTruncation()，或使用 watch 监听 data.information 并配合 nextTick 重检；
- 无障碍友好：为按钮添加 role="button"、tabindex 和 aria-expanded，提升可访问性。
该方案兼顾健壮性与响应式语义，已在 Vue 3.2+ + TypeScript 项目中稳定运行，是检测 line-clamp 截断状态的生产级实践。
