Skip to content

Ellipsis 文本省略

用于文本省略显示的组件,支持单行和多行省略。

基础用法

单行省略

当文本内容超出容器宽度时,会自动显示省略号。

这是一段很长的文本,会被省略显示

多行省略

通过 lines 属性可以设置显示的行数。

这是一段很长的文本,会被省略显示,支持多行省略,当文本内容超过指定行数时会显示省略号

自定义宽度

可以通过父容器的宽度来控制省略的触发。

这是一段很长的文本,会被省略显示

禁用工具提示

通过 show-tooltip 属性可以控制是否显示工具提示。当文本被省略时,会显示 Element Plus 风格的 tooltip。

这是一段很长的文本,会被省略显示,但是禁用了 tooltip 功能

智能 Tooltip

组件会智能判断文本是否被省略,只有在文本被省略时才会显示 tooltip。

长文本(会显示 tooltip):

这是一段很长的文本,会被省略显示,当文本被省略时会显示 tooltip

短文本(不会显示 tooltip):

短文本

API

Props

参数说明类型默认值
text要显示的文本内容string''
lines显示行数number1
showTooltip是否显示工具提示booleantrue
maxWidth最大宽度string | number''

Events

事件名说明回调参数
-暂无事件-

Slots

插槽名说明作用域参数
-暂无插槽-

注意事项

  1. 组件会自动检测文本是否需要省略
  2. 多行省略使用了 -webkit-line-clamp 属性,在部分浏览器中可能不支持
  3. 使用 Element Plus 的 el-tooltip 组件,样式与 Element Plus 保持一致
  4. 只有在文本被省略时才会显示 tooltip,避免不必要的提示
  5. 组件会响应文本内容的变化,自动重新计算是否需要省略
  6. Tooltip 显示延迟为 200ms,避免频繁触发

Released under the MIT License.