Skip to content
在新窗口打开实时预览

ReadMore 阅读更多 ​

用于内容较长时预先收起一部分、点击展开全部内容的场景,超出占位高度才显示展开按钮。

平台兼容性 ​

H5App微信小程序支付宝小程序
√√√√

基础用法 ​

vue
<snake-read-more :show-height="400">
  <rich-text :nodes="content" />
</snake-read-more>

展开与收起 ​

vue
<snake-read-more toggle close-text="展开阅读全文" open-text="收起">
  <text>长内容……</text>
</snake-read-more>

toggle 为 true 时,展开后显示收起按钮;内容动态变化后可通过 ref.init() 重新测量高度。

异步富文本、图片加载完成或语言切换后都可能改变高度,应在内容更新后的 nextTick 调用 init();不要用固定字符数代替高度测量。

API ​

Props ​

参数说明类型默认值
showHeight显示占位高度,数值按 rpx 处理number | string400
toggle展开后是否显示收起按钮booleanfalse
closeText收起状态的提示文字string语言包默认值
openText展开状态的提示文字string语言包默认值
color提示文字颜色string--snake-color-primary
fontSize提示文字大小,数值按 rpx 处理number | string28
shadowStyle收起时覆盖在内容底部的阴影样式object | array渐隐到 surface 的默认阴影
textIndent段落首行缩进string2em
indexopen/close 事件回调中的标识值number | string''
customClass / customStyle自定义类名和样式string | object | array''

Events ​

事件名触发时机参数
open展开index
close收起index

Methods ​

方法名说明
init重新测量内容高度并刷新展开状态

Slots ​

插槽名说明
default需要折叠的长内容

主题变量 ​

变量名说明
--snake-color-primary展开和收起按钮颜色
--snake-color-surface收起状态渐隐终点颜色
--snake-color-text-secondary正文默认颜色

为 uni-app 商城与 CMS 场景设计