富文本编辑区必须用contenteditable="true"的div而非textarea,因其支持加粗、列表等富文本功能;工具栏须用role="toolbar"并配aria-label;Markdown场景禁用execCommand,改用手动选区操作。

富文本编辑区必须用 contenteditable,不能只靠 textarea
直接把 textarea 当编辑区用,等于放弃所有富文本能力:加粗、列表、图片插入、格式粘贴全失效。浏览器原生不支持在 textarea 里渲染 HTML 或响应 execCommand。
正确做法是用一个 div(或 section)设 contenteditable="true",并手动控制其可聚焦性:
-
contenteditable元素必须有tabindex="0",否则键盘无法聚焦,Safari 和旧 Edge 里点按钮必静默失败 - 首次加载后要主动调
editor.focus(),尤其移动端 iOS Safari,不聚焦后续输入会被吞掉 - 避免嵌套多个
contenteditable,父子都设会导致光标行为混乱、选区丢失 - 不要给编辑区设
white-space: pre-wrap之类强制换行样式,会干扰浏览器默认的段落生成逻辑
工具栏容器必须用 role="toolbar",禁用 <toolbar></toolbar> 标签
HTML 标准里根本没有 <toolbar></toolbar> 这个元素,硬写等于无效标签,屏幕阅读器读不出用途,WCAG 4.1.2 直接报错。
语义正确的写法只有一种:
立即学习“前端免费学习笔记(深入)”;
<div role="toolbar" aria-label="文档编辑工具栏">
<button onclick="format('bold')">B</button>
<button onclick="format('insertUnorderedList')">•</button>
</div>关键细节:
- 必须配
aria-label(或aria-labelledby),光写role="toolbar"不够 - 工具栏和编辑区之间不能有 DOM 隔离(比如中间插了个
hr或空div),否则selectionchange事件监听容易失灵 - 按钮状态要靠
document.queryCommandState('bold')实时同步,别只靠 JS 变量存状态——浏览器内部状态才是唯一可信源
Markdown 场景下绝对不要用 execCommand
加粗按钮点一下输出 <strong>xxx</strong>,但 Markdown 编辑器要的是 **xxx**;列表按钮生成 <ul><li>xxx</li></ul>,而用户期待的是行首加 - xxx。二者目标根本冲突。
混用的后果很具体:
- 光标随机消失(DOM 结构被 execCommand 强制重排后脱离文本节点)
- 连续输入触发双星号自动补全失败(如输入
**|**本该变成**|**,结果变成****|) - 粘贴带格式文本后,Markdown 解析器直接崩溃(HTML 混入纯文本流)
替代方案是手动操作选区:
- 获取
window.getSelection(),提取anchorNode和focusNode - 用
Range.extractContents()拿出纯文本,包裹**或- - 用
Range.insertNode()写回,并用Range.collapse(false)重置光标位置
移动端 Safari 的 formatBlock 等命令基本不可用
在 iOS Safari 上调 document.execCommand('formatBlock', false, '<h2>')</h2>,大概率返回 false 且无任何提示。这不是 bug,是 Apple 明确限制了部分命令的实现深度。
实际能稳定工作的只有极少数命令:
-
bold、italic、underline(基础强调) -
insertHorizontalRule(仅限插入<hr>) -
createLink(需传完整 URL 字符串)
其他一律降级为手动 DOM 操作:
- 标题 → 在光标行前插入
<h2>xxx</h2>并重置光标 - 段落 → 插入
<p><br></p>,而非依赖formatBlock - 列表 → 判断当前行是否为空,空行则插入
<ul><li><br></li></ul>,非空则提取文本再包<li>
真正麻烦的从来不是功能怎么写,而是不同浏览器对同一命令的响应差异——iOS Safari 的静默失败、Chrome 对空行 insertUnorderedList 的孤立 <ul></ul>、Firefox 对 justifyCenter 的段落级作用域限制,都得一个个兜底处理。



















