Skip to content

文本省略 Ellipsis


文本过长自动处理省略号,支持按照文本长度和最大行数两种方式截取

何时使用

  • 当文本长度超过展示区域,需要自动处理省略号时

基本使用

住在我心里孤独的 孤独的海怪 痛苦之王 开始厌倦 深海的光 停滞的海浪
住在我心里孤独的 孤独的海怪 痛苦之王 开始厌倦 深海的光 停滞的海浪
Show Code
vue
<template>
  <Ellipsis :maxWidth="240">
    住在我心里孤独的 孤独的海怪 痛苦之王 开始厌倦 深海的光 停滞的海浪
  </Ellipsis>
</template>

多行省略

电灯熄灭 物换星移 泥牛入海
黑暗好像 一颗巨石 按在胸口
独脚大盗 百万富翁 摸爬滚打
黑暗好像 一颗巨石 按在胸口
电灯熄灭 物换星移 泥牛入海
黑暗好像 一颗巨石 按在胸口
独脚大盗 百万富翁 摸爬滚打
黑暗好像 一颗巨石 按在胸口
Show Code
vue
<template>
  <Ellipsis :line="2">
    电灯熄灭 物换星移 泥牛入海<br>黑暗好像 一颗巨石 按在胸口<br>独脚大盗
    百万富翁 摸爬滚打<br>黑暗好像 一颗巨石 按在胸口
  </Ellipsis>
</template>

点击展开

电灯熄灭 物换星移 泥牛入海
黑暗好像 一颗巨石 按在胸口
独脚大盗 百万富翁 摸爬滚打
黑暗好像 一颗巨石 按在胸口
电灯熄灭 物换星移 泥牛入海
黑暗好像 一颗巨石 按在胸口
独脚大盗 百万富翁 摸爬滚打
黑暗好像 一颗巨石 按在胸口
Show Code
vue
<template>
  <Ellipsis expand :line="2">
    电灯熄灭 物换星移 泥牛入海<br>黑暗好像 一颗巨石 按在胸口<br>独脚大盗
    百万富翁 摸爬滚打<br>黑暗好像 一颗巨石 按在胸口
  </Ellipsis>
</template>

定制 Tooltip 内容

《秦皇岛》
住在我心里孤独的
孤独的海怪 痛苦之王
开始厌倦 深海的光 停滞的海浪
住在我心里孤独的 孤独的海怪 痛苦之王 开始厌倦 深海的光 停滞的海浪
Show Code
vue
<template>
  <Ellipsis :max-width="240">
    住在我心里孤独的 孤独的海怪 痛苦之王 开始厌倦 深海的光 停滞的海浪
    <template #tooltip>
      <div style="text-align: center">
        《秦皇岛》<br>住在我心里孤独的<br>孤独的海怪 痛苦之王<br>开始厌倦
        深海的光 停滞的海浪
      </div>
    </template>
  </Ellipsis>
</template>

APIs

参数说明类型默认值必传
maxWidth文本最大宽度number | string'100%'false
line最大行数numberundefinedfalse
expand是否启用点击文本展开全部booleanfalsefalse
tooltip是否启用文本提示框booleantruefalse
tooltipMaxWidth提示框内容最大宽度,单位px,默认不设置时,提示文本内容自动与展示文本宽度保持一致numberundefinedfalse
tooltipFontSize提示文本字体大小,单位px,优先级高于 overlayStylenumber14false
tooltipColor提示文本字体颜色,优先级高于 overlayStylestring'#FFF'false
tooltipBackgroundColor提示框背景颜色,优先级高于 overlayStylestring'rgba(0, 0, 0, .85)'false
tooltipOverlayStyle提示框内容区域样式CSSProperties{padding: '8px 12px', textAlign: 'justify'}false

Events

事件名称说明参数
expandChange点击文本展开收起时的回调(expand: boolean) => void

Released under the MIT License.