RichTextEditor 富文本编辑器
uni-appH5微信小程序App
uni-app 跨端 富文本编辑器 组件。
何时使用
文章、公告、商品详情、邮件正文等需要基础富文本编辑(而非纯文本域)的场景。
何时不使用
需要协同编辑、复杂表格、批注、公式等重级能力时,请使用专业编辑器;纯短文本用 Textarea。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "" | 富文本内容(HTML),v-model 绑定 |
placeholder | string | "" | 占位文案 |
disabled | boolean | false | 禁用 |
readonly | boolean | false | 只读 |
toolbar | string[] | - | 工具栏按钮列表,缺省为全部 |
minHeight | number | string | - | 编辑区最小高度 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 内容变化时触发,携带最新 HTML,用于 v-model |
change | string | 内容变化时触发,携带最新 HTML |
示例
基础用法
vue
<RichTextEditor v-model="text" placeholder="输入发布内容…" />只读模式
vue
<RichTextEditor v-model="text" readonly />自定义工具栏
vue
<RichTextEditor v-model="text" :toolbar="['bold', 'italic', 'list']" placeholder="仅保留基础排版" />