跳到主要内容

RichTextEditor 富文本编辑器 ​

uni-appH5微信小程序App

uni-app 跨端 富文本编辑器 组件。

何时使用 ​

文章、公告、商品详情、邮件正文等需要基础富文本编辑(而非纯文本域)的场景。

何时不使用 ​

需要协同编辑、复杂表格、批注、公式等重级能力时,请使用专业编辑器;纯短文本用 Textarea。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
RichTextEditor 富文本编辑器 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValuestring""富文本内容(HTML),v-model 绑定
placeholderstring""占位文案
disabledbooleanfalse禁用
readonlybooleanfalse只读
toolbarstring[]-工具栏按钮列表,缺省为全部
minHeightnumber | string-编辑区最小高度

Events ​

名称载荷说明
update:modelValuestring内容变化时触发,携带最新 HTML,用于 v-model
changestring内容变化时触发,携带最新 HTML

示例 ​

基础用法 ​

vue
<RichTextEditor v-model="text" placeholder="输入发布内容…" />

只读模式 ​

vue
<RichTextEditor v-model="text" readonly />

自定义工具栏 ​

vue
<RichTextEditor v-model="text" :toolbar="['bold', 'italic', 'list']" placeholder="仅保留基础排版" />