更新记录
0.0.5(2025-08-31) 下载此版本
- chore: 更新文档
0.0.4(2025-04-25) 下载此版本
- feat: 兼容uniappx 鸿蒙next
0.0.3(2025-02-09) 下载此版本
- chore: 更新文档
平台兼容性
uni-app(4.73)
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | - | 5.0 | √ | √ |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
√ | - | - | - | - | - | - | - | - | - | - |
uni-app x(4.75)
Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
---|---|---|---|---|---|
√ | √ | 5.0 | √ | √ | √ |
其他
多语言 | 暗黑模式 | 宽屏模式 |
---|---|---|
× | √ | × |
lime-read-more 阅读更多组件
一个功能丰富的阅读更多组件,用于展示长文本内容。支持自定义展开/收起文本、图标、高度、颜色等多种配置,可用于文章预览、产品描述、用户评论等多种场景。组件提供了丰富的自定义选项,可以满足各种内容展示需求。
插件依赖:
lime-icon
、lime-shared
、lime-style
文档链接
📚 组件详细文档请访问以下站点:
安装方法
- 在uni-app插件市场中搜索并导入
lime-read-more
- 导入后可能需要重新编译项目
- 在页面中使用
l-read-more
组件
::: tip 注意🔔 本插件依赖的lime-svg在 uniapp x app中是原生插件,如果购买(收费为5元)则需要自定义基座,才能使用!uniapp可忽略。
如果不需要lime-svg在项目里删除即可 :::
代码演示
基础用法
最简单的阅读更多组件用法,将长文本内容放在组件内部。
<l-read-more>
<view>
<text>那一天我二十一岁,在我一生的黄金时代,我还有好多奢望。我想爱,想吃,还想在一瞬间变成天上半明半暗的云。后来我知道,生活就是个缓慢受槌的过程,人一天天老下去,奢望也一天天消失,最后变得像挨了槌的牛一样。可是我二十一岁生日时没预见到这一点。我觉得自己会永远生猛下去,什么也槌不了我。——王小波《黄金时代》</text>
</view>
</l-read-more>
自定义展开/收起文本
设置展开和收起时显示的文本内容。
<l-read-more
expand-text="查看全文"
collapse-text="收起内容"
>
<view>
<text>长文本内容...</text>
</view>
</l-read-more>
自定义展开/收起图标
设置展开和收起时显示的图标。
<l-read-more
expand-icon="arrow-down"
collapse-icon="arrow-up"
>
<view>
<text>长文本内容...</text>
</view>
</l-read-more>
自定义收起高度
设置收起状态时内容的显示高度。
<l-read-more height="150px">
<view>
<text>长文本内容...</text>
</view>
</l-read-more>
自定义文本颜色和字体大小
设置展开/收起按钮的文本颜色和字体大小。
<l-read-more
text-color="#1989fa"
font-size="16px"
>
<view>
<text>长文本内容...</text>
</view>
</l-read-more>
自定义遮罩颜色
设置收起状态时底部遮罩的渐变颜色。
<l-read-more
:mask-color="['#ffffff', 'rgba(255, 255, 255, 0.5)']"
>
<view>
<text>长文本内容...</text>
</view>
</l-read-more>
禁用状态
设置组件为禁用状态,禁用后无法点击展开或收起。
<l-read-more :disabled="true">
<view>
<text>长文本内容...</text>
</view>
</l-read-more>
使用v-model控制展开/收起
通过v-model双向绑定控制组件的展开/收起状态。
<l-read-more v-model="isExpanded">
<view>
<text>长文本内容...</text>
</view>
</l-read-more>
export default {
data() {
return {
isExpanded: false
}
}
}
快速预览
导入插件后,可以直接使用以下标签查看演示效果:
<!-- 代码位于 uni_modules/lime-read-more/components/lime-read-more -->
<lime-read-more />
插件标签说明
标签名 | 说明 |
---|---|
l-read-more |
组件标签 |
lime-read-more |
演示标签 |
Vue2使用说明
main.js中添加以下代码:
// vue2项目中使用
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)
详细配置请参考官方文档:Vue Composition API
API文档
Props 属性说明
属性名 | 说明 | 类型 | 默认值 |
---|---|---|---|
modelValue | 是否展开,可使用v-model双向绑定 | boolean | false |
value | 是否展开(兼容旧版本) | boolean | false |
disabled | 是否禁用,禁用后无法点击展开或收起 | boolean | false |
expandText | 展开按钮的文本 | string | '展开更多' |
expandIcon | 展开按钮的图标名称 | string | 'chevron-down' |
collapseText | 收起按钮的文本 | string | '收起' |
collapseIcon | 收起按钮的图标名称 | string | 'chevron-up' |
height | 收起状态时的内容高度 | string | '100px' |
fontSize | 展开/收起按钮的字体大小 | string | - |
textColor | 展开/收起按钮的文本颜色 | string | - |
maskColor | 遮罩的渐变颜色数组 | Array | - |
Events 事件
事件名 | 说明 | 回调参数 |
---|---|---|
change | 展开/收起状态变化时触发 | value: boolean |
click | 点击展开/收起按钮时触发 | - |
Slots 插槽
名称 | 说明 |
---|---|
default | 需要展示的内容 |
主题定制
组件提供了以下CSS变量,可用于自定义样式:
变量名称 | 默认值 | 描述 |
---|---|---|
--l-read-more-handle-color |
$text-color-3 |
展开/收起按钮的文本颜色 |
--l-read-more-handle-disabled-color |
$text-color-3 |
禁用状态下按钮的文本颜色 |
--l-read-more-handle-padding |
10px |
展开/收起按钮的内边距 |
--l-read-more-handle-gap |
4px |
按钮文本与图标之间的间距 |
--l-read-more-read-start |
rgba(255, 255, 255, 0.9) |
遮罩渐变的起始颜色 |
--l-read-more-read-end |
rgba(255, 255, 255, 0.3) |
遮罩渐变的结束颜色 |
--l-read-more-font-size |
$font-size |
按钮文本的字体大小 |
--l-read-more-icon-size |
$font-size-md |
按钮图标的大小 |
支持与赞赏
如果你觉得本插件解决了你的问题,可以考虑支持作者:
支付宝赞助 | 微信赞助 |
---|---|
![]() |
![]() |