引入

通过以下方式来全局注册组件，更多注册方式请参考组件注册。

import { createApp } from 'vue';
import { TextEllipsis } from 'vant';

const app = createApp();
app.use(TextEllipsis);

基础用法

默认展示 1 行，超过 1 行显示省略号。

<van-text-ellipsis :content="text" />

export default {
  setup() {
    const text = '慢慢来，不要急，生活给你出了难题，可也终有一天会给出答案。';
    return { text };
  },
};

展开/收起

超过行数支持展开/收起。

<van-text-ellipsis :content="text" expand-text="展开" collapse-text="收起" />

export default {
  setup() {
    const text =
      '似水流年是一个人所有的一切，只有这个东西，才真正归你所有。其余的一切，都是片刻的欢娱和不幸，转眼间就已跑到那似水流年里去了。';
    return { text };
  },
};

自定义展示行数

通过设置 rows 限制展示行数。

<van-text-ellipsis
  rows="3"
  :content="text"
  expand-text="展开"
  collapse-text="收起"
/>

export default {
  setup() {
    const text =
      '那一天我二十一岁，在我一生的黄金时代。我有好多奢望。我想爱，想吃，还想在一瞬间变成天上半明半暗的云。后来我才知道，生活就是个缓慢受锤的过程，人一天天老下去，奢望也一天天消失，最后变得像挨了锤的牛一样。可是我过二十一岁生日时没有预见到这一点。我觉得自己会永远生猛下去，什么也锤不了我。';
    return { text };
  },
};

自定义省略位置

通过设置 position 控制省略位置。

• 头部省略：

<van-text-ellipsis
  rows="1"
  :content="text"
  expand-text="展开"
  collapse-text="收起"
  position="start"
/>

export default {
  setup() {
    const text =
      '那一天我二十一岁，在我一生的黄金时代。我有好多奢望。我想爱，想吃，还想在一瞬间变成天上半明半暗的云。后来我才知道，生活就是个缓慢受锤的过程，人一天天老下去，奢望也一天天消失，最后变得像挨了锤的牛一样。可是我过二十一岁生日时没有预见到这一点。我觉得自己会永远生猛下去，什么也锤不了我。';
    return { text };
  },
};

• 中部省略：

<van-text-ellipsis
  rows="2"
  :content="text"
  expand-text="展开"
  collapse-text="收起"
  position="middle"
/>

export default {
  setup() {
    const text =
      '那一天我二十一岁，在我一生的黄金时代。我有好多奢望。我想爱，想吃，还想在一瞬间变成天上半明半暗的云。后来我才知道，生活就是个缓慢受锤的过程，人一天天老下去，奢望也一天天消失，最后变得像挨了锤的牛一样。可是我过二十一岁生日时没有预见到这一点。我觉得自己会永远生猛下去，什么也锤不了我。';
    return { text };
  },
};

自定义操作内容

通过插槽 action 自定义操作内容。

<van-text-ellipsis :content="text">
  <template #action="{ expanded }">{{ expanded ? '收起' : '展开' }}</template>
</van-text-ellipsis>

export default {
  setup() {
    const text = '慢慢来，不要急，生活给你出了难题，可也终有一天会给出答案。';
    return { text };
  },
};

Props

参数	说明	类型	默认值
rows	展示的行数	number | string	1
content	需要展示的文本	string	-
expand-text	展开操作的文案	string	-
collapse-text	收起操作的文案	string	-
dots v4.2.0	省略号的文本内容	string	'...'
position v4.6.2	省略位置，可选值为 start middle	string	'end'

Events

事件名	说明	回调参数
click-action	点击展开/收起时触发	event: MouseEvent

TextEllipsis 方法

通过 ref 可以获取到 TextEllipsis 实例并调用实例方法，详见组件实例方法。

方法名	说明	参数	返回值
toggle	切换文本的展开状态，传 true 为展开，false 为收起，不传参为切换	expanded?: boolean	-

Slots

名称	说明	参数
action v4.8.3	自定义操作	{ expanded: boolean }

类型定义

组件导出以下类型定义：

import type {
  TextEllipsisProps,
  TextEllipsisInstance,
  TextEllipsisThemeVars,
} from 'vant';

TextEllipsisInstance 是组件实例的类型，用法如下：

import { ref } from 'vue';
import type { TextEllipsisInstance } from 'vant';

const textEllipsisRef = ref<TextEllipsisInstance>();

textEllipsisRef.value?.toggle();

样式变量

组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 ConfigProvider 组件。

名称	默认值	描述
--van-text-ellipsis-action-color	var(--van-blue)	操作按钮的颜色
--van-text-ellipsis-line-height	1.6	文本的行高