LimeUI+1.2.0

主题

LimeTextEllipsis 文本省略组件 ​

一个功能丰富的文本省略组件，用于处理文本内容超出指定行数时的显示问题。支持单行和多行省略、自定义省略符号、展开/收起功能等多种配置，可用于长文本展示、产品描述、评论内容等多种场景。组件提供了丰富的自定义选项，可以满足各种文本省略需求。

插件依赖：lime-shared、lime-style

文档链接 ​

📚 组件详细文档请访问以下站点：

安装方法 ​

  1. 在uni-app插件市场入口 中搜索并导入lime-text-ellipsis
  2. 导入后可能需要重新编译项目
  3. 在页面中使用l-text-ellipsis组件

代码演示 ​

基础用法 ​

最简单的文本省略组件用法，默认单行省略。

html
<l-text-ellipsis content="这是一段很长的文本内容，当文本内容超出一行时会自动省略显示"></l-text-ellipsis>

多行省略 ​

设置最大显示行数，超出部分省略。

html
<l-text-ellipsis 
  :rows="2" 
  content="这是一段很长的文本内容，当文本内容超出两行时会自动省略显示。这是一段很长的文本内容，当文本内容超出两行时会自动省略显示。"
></l-text-ellipsis>

自定义省略符号 ​

设置自定义的省略符号，替代默认的"…"。

html
<l-text-ellipsis 
  content="这是一段很长的文本内容，当文本内容超出一行时会自动省略显示" 
  dots="..."
></l-text-ellipsis>

展开/收起功能 ​

添加展开和收起按钮，允许用户查看完整内容。

html
<l-text-ellipsis 
  :rows="2" 
  expand-text="展开" 
  collapse-text="收起" 
  content="这是一段很长的文本内容，当文本内容超出两行时会自动省略显示。这是一段很长的文本内容，当文本内容超出两行时会自动省略显示。这是一段很长的文本内容，当文本内容超出两行时会自动省略显示。"
></l-text-ellipsis>

自定义操作按钮位置 ​

设置展开/收起按钮的位置。

html
<l-text-ellipsis 
  :rows="2" 
  expand-text="展开" 
  collapse-text="收起" 
  position="right" 
  content="这是一段很长的文本内容，当文本内容超出两行时会自动省略显示。这是一段很长的文本内容，当文本内容超出两行时会自动省略显示。"
></l-text-ellipsis>

自定义操作按钮颜色 ​

设置展开/收起按钮的颜色。

html
<l-text-ellipsis 
  :rows="2" 
  expand-text="展开" 
  collapse-text="收起" 
  action-color="#ff5500" 
  content="这是一段很长的文本内容，当文本内容超出两行时会自动省略显示。这是一段很长的文本内容，当文本内容超出两行时会自动省略显示。"
></l-text-ellipsis>

快速预览 ​

导入插件后，可以直接使用以下标签查看演示效果：

html
<!-- 代码位于 uni_modules/lime-text-ellipsis/components/lime-text-ellipsis -->
<lime-text-ellipsis />

插件标签说明 ​

标签名说明
l-text-ellipsis组件标签
lime-text-ellipsis演示标签

Vue2使用说明 ​

main.js中添加以下代码：

js
// vue2项目中使用
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

详细配置请参考官方文档：Vue Composition API

API文档 ​

Props 属性说明 ​

属性名说明类型默认值
rows最大显示行数number | string1
content文本内容string-
dots省略符号string…
expandText展开按钮文字string-
collapseText收起按钮文字string-
position展开/收起按钮位置string-
actionColor展开/收起按钮颜色string-

Events 事件 ​

事件名说明回调参数
expand展开时触发-
collapse收起时触发-

Slots 插槽 ​

名称说明
default自定义文本内容
expand自定义展开按钮
collapse自定义收起按钮

主题定制 ​

组件提供了以下CSS变量，可用于自定义样式：

变量名称默认值描述
--l-text-ellipsis-line-height1.6文本行高
--l-text-ellipsis-action-color$primary-color操作按钮颜色
--l-text-ellipsis-color$text-color-1文本颜色

支持与赞赏 ​

如果你觉得本插件解决了你的问题，可以考虑支持作者：

支付宝赞助微信赞助

源代码 ​

组件源码