#使用须知 * 1、这是一个小说分页插件,不包含设置窗口 * 2、这个插件有3个组件,分别是yingbing-html-reader | yingbing-text-reader | yingbing-whole-reader * 3、插件本身只支持滚动阅读,如果需要翻页功要配合[好用翻页插件](https://ext.dcloud.net.cn/plugin?id=13712)同时下载使用 * 4、h5页面电量显示只能在安全环境下获取(比如:https://、file:///、localhost://) * 5、使用本插件一定要仔细阅读下面的文档,以及下载示例 * 6、有什么不懂,可以加群 1087735942 聊 #yingbing-html-reader html文本阅读插件 只支持(APP-VUE || H5 || MP-WEIXIN) * 微信小程序使用这个组件性能较差,尽量避免一段很长的文本,最好将每句话都单独用p标签包裹 * 传入的chapter章节序号必须是大于0的正整数 * 组件提供了2个特殊的标签full-box和whole-render,whole-render标签包裹的所有内容都是整体渲染,不会被切割,full-box继承了内容区域的全部高度,其余和whole-render一样 * full-box标签和whole-render标签不要包裹使用 * 一定要保证标签的完整性比如<p>标签后面一定要接一个</p>,否则可能会导致排版错乱,微信小程序极大的增加排版时间 * props属性 | 属性名 | 类型 | 默认值 | 可选值 | 说明 | | :----- | :----: | :----: | :----: | :---- | | autoplay | Boolean | false | true/false | 自动翻页 | | interval | String/Number | 5000 | ---- | 自动翻页周期 | | pageType | String | scroll | real/cover/scroll/none | 翻页模式 | | split | String | '' | ---- | 分隔符排版字符串(默认为空表示单个字符分隔计算排版,如果传入如空格符,则表示以空格分隔字符串进行计算排版,适用于英文小说) | | color | String | #333333 | ---- | 字体颜色 | | fontSize | String/Number | 15 | ---- | 字体大小 | | fontFamily | String | Arial | ---- | 字体名称 | | background | String | #fcd281 | ---- | 背景颜色(支持css渐变) | | lineHeight | String/Number | fontSize + 15 | ---- | 行高 | | slide | String/Number | 40 | ---- | 页面左右边距 | | topGap | String/Number | 10 | ---- | 页面上边距 | | bottomGap | String/Number | 10 | ---- | 页面下边距 | | headerShow | Boolean | true | true/false | 显示顶部内容 | | footerShow | Boolean | true | true/false | 显示底部内容 | | backShow | Boolean | false | true/false | 显示顶部返回按钮 | | preloadable | Boolean | false | true/false | 开启预加载章节功能 | | selectable | Boolean | false | true/false | 开启文本选择 | | loadPageNum | Number/String | 5 | ---- | 距离最后还有多少页时开始加载下一章节(需要配合preloadable属性使用) | | unableClickPage | Boolean | false | true/false | 是否关闭点击左右2边位置翻页(pageType为none时忽略此属性) | | totalChapter | Number/String | 0 | ---- | 总章节数量用于计算顶部右上角的阅读进度 | | clickOption | Object | { width: uni.upx2px(200),height: uni.upx2px(200),left:'auto',top:'auto'} | ---- | 点击区域配置(点击哪个区域有效 enableClick为true时有效) | | loadingText | String | '内容排版中' | ---- | 初始化或者跳转等待的提示文字 | | errorText | String | '渲染失败\n\n点击重试' | ---- | 初始化或者跳转失败的提示文字 | | prevChapterDefaultText | String | '加载上一章' | ---- | 加载上一章的默认文字 | | nextChapterDefaultText | String | '加载下一章' | ---- | 加载下一章的默认文字 | | chapterReadyText | String | '松开加载' | ---- | 章节准备加载的提示文字 | | chapterLoadingText | String | '正在加载' | ---- | 章节加载中的提示文字 | | chapterSuccessText | String | '加载成功' | ---- | 章节加载成功的提示文字 | | chapterFailText | String | '加载失败' | ---- | 章节加载失败的提示文字 | | prevChapterEndText | String | '前面没有了' | ---- | 前面章节加载完毕的提示文字 | | nextChapterEndText | String | '后面没有了' | ---- | 后面章节加载完毕的提示文字 | * clickOption介绍 | 键名 | 类型 | 说明 | | :----- | :----: | :---- | | width | Number | 点击区域宽度 | | height | Number | 点击区域高度 | | left | String/Number | 左右定位(默认auto为居中,可传入数字) | | top | String/Number | 上下定位(默认auto为居中,可传入数字) | * event事件 | 事件名 | 说明 | | :----- | :---- | | loadmore | 加载章节内容事件 | | change | 阅读页面改变触发事件(返回当前阅读页面信息)| | back | 点击顶部返回按钮事件 | | single-click | 单击事件(配合clickOption使用) | | double-click | 双击事件(配合clickOption使用) | | long-click | 长按事件(配合clickOption使用) | * 内置方法 | 方法名 | 说明 | | :--- | :---- | | init | 初始化小说内容 | | change | 跳转小说位置 | | refresh | 刷新阅读页面 | | next | 翻到下一页 (滚动模式下表现为向下滚动一段距离) | | prev | 翻到上一页 (滚动模式下表现为向上滚动一段距离) | | setContent | 更新当前页面的内容(主要用于更改文字颜色等不会影响排版的样式) | * 支持的文本格式 ```javascript const text1 = '文本文本文本\r\n文本文本'//组件会自动替换换行符为
,如果要使用纯文本格式建议使用yingbing-text-reader组件 const text2 = '

文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本

文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本

' const text3 = '文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本
文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本' ``` * 插件使用 ```html