# ReadMore 展开阅读更多
该组件一般用于内容较长,预先收起一部分,点击展开全部内容的场景。
# 平台差异说明
App(vue) | App(nvue) | H5 | 小程序 |
---|---|---|---|
√ | √ | √ | √ |
# 基本使用
通过slot传入正文内容
<template>
<up-read-more>
<rich-text :nodes="content"></rich-text>
</up-read-more>
</template>
<script setup>
import { ref } from 'vue';
const content = ref(`山不在高,有仙则名。水不在深,有龙则灵。斯是陋室,惟吾德馨。
苔痕上阶绿,草色入帘青。谈笑有鸿儒,往来无白丁。可以调素琴,阅金经。
无丝竹之乱耳,无案牍之劳形。南阳诸葛庐,西蜀子云亭。孔子云:何陋之有?`);
</script>
# 兼容性
由于一些微信小程序平台的渲染能力的问题,在解析up-parse组件内容时会比较耗时,导致read-more
组件内部无法准确得知
内容的高度,而出现计算错误,这种情况下,我们需要借助up-parse
组件的@load
(内容多为文字时)或者@ready
(内容多为图片时,可能会有较大延时)事件,通过ref
重新初始化read-more
组件的高度,如下:
<template>
<up-read-more ref="uReadMoreRef">
<up-parse :content="content" @load="load"></up-parse>
</up-read-more>
</template>
<script setup>
import { ref, onMounted } from 'vue';
// 创建响应式数据
const content = ref(`山不在高,有仙则名。水不在深,有龙则灵。斯是陋室,惟吾德馨。
苔痕上阶绿,草色入帘青。谈笑有鸿儒,往来无白丁。可以调素琴,阅金经。
无丝竹之乱耳,无案牍之劳形。南阳诸葛庐,西蜀子云亭。孔子云:何陋之有?`);
// 创建组件引用
const uReadMoreRef = ref(null);
// 定义方法
function load() {
if (uReadMoreRef.value) {
uReadMoreRef.value.init();
}
}
// 如果需要在组件挂载后调用 load 方法,可以使用 onMounted 钩子
onMounted(() => {
load();
});
</script>
# 展开收起
配置toggle
为true
,展开后可以收起,否则展开后没有收起的按钮
<up-read-more :toggle="true">
<rich-text :nodes="content"></rich-text>
</up-read-more>
# 配置展开高度
可以配置一个高度,单位rpx,只有slot传入的内容高度超出这个值,才会出现"展开阅读全文"字样的按钮
<up-read-more showHeight="600">
<rich-text :nodes="content"></rich-text>
</up-read-more>
# 异步初始化
有时候需要展示的内容是从后端获取的,组件内部的mounted
生命周期初始化时,请求尚未回来,会导致
内容的高度在初始化有误差。可以在请求完毕渲染后(指的是this.$nextTick),通过ref
调用组件的init
方法,重新初始化
<template>
<up-read-more ref="uReadMoreRef">
<rich-text :nodes="content"></rich-text>
</up-read-more>
</template>
<script setup>
import { ref, onMounted } from 'vue';
// 创建响应式数据
const content = ref('');
// 创建组件引用
const uReadMoreRef = ref(null);
// 模拟后端请求
async function fetchData() {
return new Promise((resolve) => {
setTimeout(() => {
resolve(`山不在高,有仙则名。水不在深,有龙则灵。斯是陋室,惟吾德馨。
苔痕上阶绿,草色入帘青。谈笑有鸿儒,往来无白丁。可以调素琴,阅金经。
无丝竹之乱耳,无案牍之劳形。南阳诸葛庐,西蜀子云亭。孔子云:何陋之有?`);
}, 2000);
});
}
// 在组件挂载后调用
onMounted(async () => {
const text = await fetchData();
content.value = text;
// 等待 DOM 更新
await nextTick();
// 调用子组件的 init 方法
if (uReadMoreRef.value) {
uReadMoreRef.value.init();
}
});
</script>
# 自定义样式
此组件上边部分有一个白色虚化的阴影,用以将点击区域与文字内容进行融合,如果您不想要这个阴影,可以调整shadowStyle
对象,此对象内部如下:
{
// #ifndef APP-NVUE
backgroundImage: "linear-gradient(-180deg, rgba(255, 255, 255, 0) 0%, #fff 80%)",
// #endif
// #ifdef APP-NVUE
// nvue上不支持设置复杂的backgroundImage属性
backgroundImage: "linear-gradient(to top, #fff, rgba(255, 255, 255, 0.5))",
// #endif
paddingTop: "100px",
marginTop: "-100px",
}
如果您不想要阴影,将backgroundImage
设置为none
即可,关于paddingTop
和marginTop
自行调整至合适数值即可。
<template>
<up-read-more ref="uReadMore" :shadowStyle="shadowStyle" :showHeight="200">
<rich-text :nodes="content"></rich-text>
</up-read-more>
</template>
<script setup>
import { reactive } from 'vue';
const state = reactive({
content: '',
shadowStyle: {
backgroundImage: "none",
paddingTop: "0",
marginTop: "20rpx"
}
});
</script>
# 右侧演示页面源代码地址
# API
# Props
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
showHeight | 内容超出此高度才会显示展开全文按钮,单位rpx | String | Number | 400 | - |
toggle | 展开后是否显示收起按钮 | Boolean | false | true |
closeText | 关闭时的提示文字 | String | 展开阅读全文 | - |
openText | 展开时的提示文字 | String | 收起 | - |
color | 提示文字的颜色 | String | #2979ff | - |
fontSize | 提示文字的大小,默认单位px | String | Number | 14 | - |
shadowStyle | 对阴影的自定义处理,对象形式 | Object | 见上方说明 | - |
textIndent | 段落首行缩进的字符个数 | String | 2em | - |
name | 用于在open 和close 事件中当作回调参数返回 | String | Number | - | - |
# Methods
此方法如要通过ref手动调用
名称 | 说明 |
---|---|
init | 重新初始化组件内部高度计算过程,如果内嵌up-parse组件时可能需要用到 |
# Events
事件名 | 说明 | 回调参数 |
---|---|---|
open | 内容被展开时触发 | name - props中传入的name 参数值 |
close | 内容被收起时触发 | name - props中传入的name 参数值 |