RichTextEditor 富文本编辑器
WebH5
富文本编辑器(够用版)。基于 contenteditable + document.execCommand 实现加粗/斜体/标题/列表/引用/代码块/链接/图片等常用编辑能力,v-model 输出 HTML 字符串。
何时使用
文章、公告、商品详情、邮件正文等需要基础富文本编辑(而非纯文本域)的场景。
何时不使用
需要协同编辑、复杂表格、批注、公式等重级能力时,请使用专业编辑器;纯短文本用 Textarea。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "" | 富文本 HTML,对应 v-model |
placeholder | string | "" | 空内容占位提示;为空时取 locale 文案 richTextEditor.placeholder(默认「请输入内容…」) |
disabled | boolean | false | 禁用,不可编辑,工具栏按钮置灰 |
readonly | boolean | false | 只读,隐藏工具栏且不可编辑 |
toolbar | string[] | "全部按钮" | 工具栏按钮按顺序渲染,支持 "divider" 分隔线;可用键:bold/italic/underline/strikethrough/heading/ul/ol/quote/code/link/image/undo/redo/clear |
minHeight | number | string | 200 | 编辑区最小高度,number 视为 px |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 内容变化时触发,携带最新 HTML,用于 v-model |
change | string | 内容变化时触发,携带最新 HTML |
示例
基础
示例加载中…
只读与禁用
示例加载中…
精简工具栏
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 RichTextEditor 文档(含手机预览)。