0.4.0 • Published 4 years ago
vue-web-highlights
Licence
MIT
Version
0.4.0
Deps
8
Size
296 kB
Vulns
8
Weekly
0
React Web Highlighter的vue版本
依据React Web Highlighter改写了vue版本
一个富文本高亮笔记前端库,支持高亮文本的持久化存储与还原
0. 在线案例
2. 安装
npm i vue-web-highlights or cnpm i vue-web-highlights
3. 使用方式
- main.js中
import {
setSelectRange,
globalVariable
} from "vue-web-highlights";
Vue.prototype.$setSelectRange = setSelectRange;
Vue.prototype.$globalVariable = globalVariable;
- 在vue组件中
<template>
<HighLight
:value="data"
:template="template"
:modes="toolBarList"
@onAdd="onAdd"
:key="update"
@onUpdate="onUpdate"
>
<ToolBar v-if="visible" :visible="visible" @onCancel="onToolBarCancel">
</ToolBar>
</HighLight>
</template>
<script>
import { HighLight, ToolBar } from "vue-web-highlights";
// components: { ToolBar, HighLight },
</script>
5. TextHighlight 组件参数说明
TextHighlight组件属性参数名 类型 描述 是否必须 默认值 template string富文本 HTML 字符串 是 --value INoteTextHighlightInfo[]高亮的选区数据 否 --tagName string用于包裹高亮文本的 HTML 标签名 否 spanonAdd (data:INoteTextHighlightInfo)=>any新增选区时触发的回调 否 --onUpdate (data:INoteTextHighlightInfo[])=>any选中已存在的选区时触发的回调(由于选区会有重叠,所以参数为数组列表,会返回当前标记当前选中选区的所有节点) 否 --rowKey string每条数据的唯一值 否 idmodes IModeProps[]用于区分类型与不同类型设置样式 否 --INoteTextHighlightInfo类型属性:参数名 类型 描述 是否必须 list INoteTextHighlightInfoItem[]选区数据 是 text string选区选中的文本数据 是 mode string当前数据类型(例如:笔记,画线等) 否 INoteTextHighlightInfoItem类型属性:参数名 类型 描述 是否必须 level number[]选区层级数据,依据顶级节点一层层下钻到选中文本节点 是 start number当前选中的开始文本节点的偏移量 是 end string当前选中的结束文本节点的偏移量 是 text string当前文本节点选中的文本 是 IModeProps类型属性:参数名 类型 描述 是否必须 mode string类型 是 className string用于设置当前类型的类名 是
5.1 ToolBar 组件参数说明
ToolBar 需作为 TextHighlight 的子元素存在
| 参数名 | 类型 | 描述 | 是否必须 | 默认值 |
|---|---|---|---|---|
| mask | boolean |
是否显示遮罩层 | 否 | true |
| visible | boolean |
用于控制弹窗的显示隐藏 | 否 | false |
| autoClosable | boolean |
点击自动触发管 | 否 | true |
| wrapClassName | string |
设置样式 | 否 | -- |
| onCancel | function |
设置关闭的回调 | 否 | -- |
| children | ReactNode |
弹窗内部的子元素 | 否 | -- |
6. 方法
setSelectRange 方法:
| 参数名 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| node | INoteTextHighlightInfo |
用于设置原生选中文本的方法 | 是 |