Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
7be353fb
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3209
Star
106
Fork
815
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
94
列表
看板
标记
里程碑
合并请求
70
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
94
Issue
94
列表
看板
标记
里程碑
合并请求
70
合并请求
70
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
7be353fb
编写于
9月 29, 2021
作者:
Q
qiang
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: update rich-text
上级
33e4062c
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
12 addition
and
17 deletion
+12
-17
docs/component/rich-text.md
docs/component/rich-text.md
+12
-17
未找到文件。
docs/component/rich-text.md
浏览文件 @
7be353fb
#### rich-text
富文本。
支持默认事件,包括:click、touchstart、touchmove、touchcancel、touchend、longpress。
**属性说明**
|属性名|类型|默认值|说明|平台兼容|
|:-|:-|:-|:-|:-|
|nodes|Array / String|[]|节点列表 / HTML String||
|space|string||显示连续空格|微信基础库2.4.1+
[
详见
](
https://developers.weixin.qq.com/miniprogram/dev/component/rich-text.html
)
、QQ小程序、快手小程序
[
详见
](
https://mp.kuaishou.com/docs/develop/components/basicComponents/richText.html
)
|
|selectable|Boolean|false|富文本是否可以长按选中,可用于复制,粘贴等场景|百度小程序(真机)|
**注意**
-
app-nvue 平台 nodes 属性只支持使用 Array 类型
-
支付宝小程序 nodes 属性只支持使用 Array 类型。
如果需要支持 HTML String,则需要自己将 HTML String转化为 nodes 数组,可使用
[
html-parser
](
https://github.com/dcloudio/hello-uniapp/blob/master/common/html-parser.js
)
转换。
支持默认事件,包括:click、touchstart、touchmove、touchcancel、touchend、longpress。
**nodes 属性推荐使用 Array 类型,由于组件会将 String 类型转换为 Array 类型,因而性能会有所下降。**
|space|string||显示连续空格|App、H5、微信基础库2.4.1+
[
详见
](
https://developers.weixin.qq.com/miniprogram/dev/component/rich-text.html
)
、QQ小程序、字节小程序、快手小程序
[
详见
](
https://mp.kuaishou.com/docs/develop/components/basicComponents/richText.html
)
|
|selectable|Boolean|true|富文本是否可以长按选中,可用于复制,粘贴等场景|百度小程序(仅真机支持,基础库 3.150.1 以下版本默认为 false)|
|image-menu-prevent|Boolean|false|阻止长按图片时弹起默认菜单(将该属性设置为image-menu-prevent或image-menu-prevent="true"),只在初始化时有效,不能动态变更;若不想阻止弹起默认菜单,则不需要设置此属性|百度小程序|
|preview|Boolean||富文本中的图片是否可点击预览。在不设置的情况下,若 rich-text 未监听点击事件,则默认开启。未显示设置 preview 时会进行点击默认预览判断,建议显示设置 preview|百度小程序|
##### nodes
现支持两种节点,通过 type 来区分,分别是元素节点和文本节点,默认是元素节点,在富文本区域里显示的 HTML 节点。
nodes 值为 HTML String 时,在组件内部将自动解析为节点列表,推荐直接使用 Array 类型避免内部转换导致的性能下降。App-nvue 和支付宝小程序不支持 HTML String 方式,仅支持直接使用节点列表即 Array 类型,如要使用 HTML String,则需自己将 HTML String 转化为 nodes 数组,可使用
[
html-parser
](
https://github.com/dcloudio/hello-uniapp/blob/master/common/html-parser.js
)
转换。
节点列表内的节点现支持两种类型,通过 type 来区分,分别是元素节点和文本节点,默认是元素节点,在富文本区域里显示的 HTML 节点。
**元素节点:type = node**
...
...
@@ -41,7 +36,7 @@
##### 受信任的HTML节点及属性
全局支持
class和style属性,
**不支持id
属性**
。
全局支持
class 和 style 属性,
**不支持 id
属性**
。
|节点|属性|
|:-|:-|
...
...
@@ -146,5 +141,5 @@ export default {
-
attrs 属性不支持 id ,支持 class 。
-
name 属性大小写不敏感。
-
如果使用了不受信任的HTML节点,该节点及其所有子节点将会被移除。
-
img 标签仅支持网络图片。
-
非 App 平台
img 标签仅支持网络图片。
-
如果在自定义组件中使用 rich-text 组件,那么仅自定义组件的 css 样式对 rich-text 中的 class 生效。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录