contenteditable 是 html5 中用于实现元素可编辑的全局属性，通过设置 true、false 或无值来控制编辑状态，结合 document.execCommand 可创建基础富文本编辑器，使用 innerHTML 获取内容并保存，适用于轻量级编辑功能开发。
在 html5 中，contenteditable 是一个非常实用的全局属性，它可以让你将任意 HTML 元素变成可编辑状态，实现富文本编辑功能。这个特性为构建轻量级的内容编辑器提供了基础支持，无需依赖 iframe 或复杂的插件即可让用户直接在网页上输入和格式化文本。
什么是 contenteditable？
contenteditable 属性可以添加到任何 HTML 元素上，例如 div、p、span 等，设置后用户就可以直接在这个元素内进行文本输入、删除、复制粘贴等操作，并保留基本的格式（如加粗、换行、列表等）。
它的取值有三种：
- contenteditable=”true”：开启编辑功能
- contenteditable=”false”：关闭编辑功能
- contenteditable（无值）：等同于 true
示例代码：
立即学习“前端免费学习笔记（深入）”；
<div contenteditable> 在这里可以输入和格式化文本... </div>
创建一个简单的富文本编辑区域
下面是一个完整的入门示例，展示如何使用 contenteditable 搭建一个基础的富文本编辑器。
<!DOCTYPE html> <html lang="zh"> <head> <meta charset="UTF-8" /> <title>富文本编辑器入门</title> <style> #editor { width: 600px; height: 300px; border: 1px solid #ccc; padding: 10px; margin-top: 10px; font-family: Arial, sans-serif; } button { margin-right: 5px; } </style> </head> <body> <p><h3>简易富文本编辑器</h3></p><p><!-- 工具栏 --> <div> <button onclick="execCmd('bold')">加粗</button> <button onclick="execCmd('italic')">斜体</button> <button onclick="execCmd('underline')">下划线</button> <button onclick="execCmd('insertUnorderedList')">项目符号</button> <button onclick="execCmd('insertOrderedList')">编号列表</button> <button onclick="execCmd('justifyLeft')">左对齐</button> <button onclick="execCmd('justifyCenter')">居中</button> <button onclick="execCmd('justifyRight')">右对齐</button> </div></p><p><!-- 可编辑区域 --> <div id="editor" contenteditable="true"> 在此处输入内容... </div></p><p><script> function execCmd(command) { document.execCommand(command, false, null); } </script></p><p></body> </html>
说明：
- 通过 document.execCommand() 方法执行常见的格式化命令（虽然该方法已废弃，但在大多数浏览器中仍广泛支持，适合学习阶段使用）
- 点击按钮会触发对应样式，比如“加粗”会应用 <strong> 标签或 style 加粗效果
- 编辑区内容的变化会实时反映在 dom 结构中
获取和保存编辑内容
由于编辑区域是普通 div，要保存用户输入的内容，只需读取其 innerHTML 即可。
添加一个保存按钮示例：
<button onclick="saveContent()">保存内容</button> <p><script> function saveContent() { const content = document.getElementById('editor').innerHTML; console.log('保存的内容：', content); // 可以通过 fetch 发送到服务器 alert('内容已输出到控制台'); } </script>
这样你就可以把带有格式的 HTML 内容存储到数据库或本地存储中，之后再渲染出来即可还原样式。
注意事项与进阶建议
虽然 contenteditable 使用简单，但实际开发中需要注意以下几点：
- 不同浏览器渲染行为可能略有差异，需测试兼容性
- 用户可能粘贴复杂格式内容，建议配合 css 清理样式或使用 js 过滤非法标签
- 现代项目推荐使用更强大的库如 Quill、TinyMCE 或 Slate.js 来构建稳定编辑器
- 如果需要高度定制化功能（如协作编辑、版本控制），应基于底层 API 构建或选用专业框架
基本上就这些。掌握 contenteditable 是理解 Web 富文本编辑的第一步，它简单却强大，适合快速原型开发和学习编辑逻辑。后续可以根据需求逐步引入更多工具和规范处理机制。