跳到主要内容

RichTextEditor 富文本编辑器 ​

WebH5

富文本编辑器(够用版)。基于 contenteditable + document.execCommand 实现加粗/斜体/标题/列表/引用/代码块/链接/图片等常用编辑能力,v-model 输出 HTML 字符串。

何时使用 ​

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

何时不使用 ​

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

Props ​

名称类型默认值说明
modelValuestring""富文本 HTML,对应 v-model
placeholderstring""空内容占位提示;为空时取 locale 文案 richTextEditor.placeholder(默认「请输入内容…」)
disabledbooleanfalse禁用,不可编辑,工具栏按钮置灰
readonlybooleanfalse只读,隐藏工具栏且不可编辑
toolbarstring[]"全部按钮"工具栏按钮按顺序渲染,支持 "divider" 分隔线;可用键:bold/italic/underline/strikethrough/heading/ul/ol/quote/code/link/image/undo/redo/clear
minHeightnumber | string200编辑区最小高度,number 视为 px

Events ​

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

示例 ​

基础 ​

示例加载中…

只读与禁用 ​

示例加载中…

精简工具栏 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 RichTextEditor 文档(含手机预览)。