引言：构建富文本编辑器的基础
在现代Web应用中，实现一个功能完善的富文本编辑器是常见的需求，例如在线文档、博客发布工具等。这类应用的核心功能之一就是允许用户对文本进行格式化，包括改变字体大小、颜色、加粗、斜体等。本文将基于一个基础的HTML结构和JavaScript逻辑，详细讲解如何实现这些功能，特别是针对选中文本进行字体大小调整的进阶技巧，并探讨document.execCommand的替代方案。
基础文本格式化功能
首先，我们来看一下如何实现粗体、斜体、下划线和文本颜色等基础格式化功能。这些功能在许多旧版浏览器中可以通过document.execCommand方法实现，尽管该方法已被弃用，但在一些简单场景下仍有使用。
HTML 结构
<html>
<head>
<meta charset="UTF-8" />
<title>Editor</title>
<link rel="stylesheet" href="index.css" />
</head>
<body>
<button class="bold" onclick="document.execCommand('bold',false,null);">
B
</button>
<button class="italic" onclick="document.execCommand('italic',false,null);">
I
</button>
<button class="underline" onclick="document.execCommand('underline',false,null);">
U̲
</button>
<input type="color" class="color-picker" id="colorPicker" oninput="changeColorText(this.value);" />
<label>选择颜色</label>
<button id="highlight"><mark>高亮</mark></button>
<input type="number" class="font-size-input" id="fontSize" min="8" max="72" value="16"/>
<label>字体大小 (px)</label>
<fieldset class="userInput" contenteditable="true">
<p>这是一个可编辑的文本区域。</p>
<p>请尝试选择文本并应用不同的格式。</p>
</fieldset>
<script src="index.js"></script>
</body>
</html>在上述HTML结构中：
- 我们创建了粗体、斜体、下划线按钮，它们通过onclick事件直接调用document.execCommand。
- 一个颜色选择器（input type="color"）用于改变文本颜色。
- 一个高亮按钮（#highlight）和一个数字输入框（#fontSize）用于字体大小调整。
- fieldset元素设置了contenteditable="true"，使其成为可编辑的区域。
JavaScript 实现
// index.js
var boldBtn = document.querySelector(".bold");
var italicBtn = document.querySelector(".italic");
var underlineBtn = document.querySelector(".underline");
var colorPicker = document.querySelector(".color-picker");
var highlightBtn = document.querySelector("#highlight");
var fontSizeInput = document.querySelector("#fontSize");
var userInput = document.querySelector('.userInput');
// 切换按钮的激活状态（可选，用于UI反馈）
boldBtn.addEventListener("click", function () {
boldBtn.classList.toggle("inUse");
});
italicBtn.addEventListener("click", function () {
italicBtn.classList.toggle("inUse");
});
underlineBtn.addEventListener("click", function () {
underlineBtn.classList.toggle("inUse");
});
highlightBtn.addEventListener("click", function () {
highlightBtn.classList.toggle("inUse");
});
// 改变文本颜色
const changeColorText = (color) => {
document.execCommand("styleWithCSS", false, true); // 确保使用CSS样式
document.execCommand("foreColor", false, color);
};
// 文本高亮功能
highlightBtn.addEventListener("click", function () {
const selection = window.getSelection();
if (!selection.rangeCount) return; // 没有选中内容则退出
const range = selection.getRangeAt(0);
const span = document.createElement("span");
span.className = "highlight"; // 可以通过CSS定义高亮样式
span.appendChild(range.extractContents()); // 将选中内容移入span
range.insertNode(span); // 将span插入回原位置
selection.removeAllRanges(); // 清除当前选区，防止重复操作
selection.addRange(range); // 重新选择新插入的span内容
});
// 字体大小调整功能 (针对选中文本)
fontSizeInput.addEventListener('input', function() {
const fontSize = this.value + 'px'; // 获取输入框的字体大小值，并加上'px'
const selection = window.getSelection();
if (!selection.rangeCount) {
// 如果没有选中任何文本，则将字体大小应用于整个编辑区域（作为备用）
userInput.style.fontSize = fontSize;
return;
}
const range = selection.getRangeAt(0);
const selectedText = range.extractContents(); // 提取选中的内容
const span = document.createElement("span");
span.style.fontSize = fontSize; // 设置span的字体大小
span.appendChild(selectedText); // 将提取的内容添加到span中
range.insertNode(span); // 将带有新字体大小的span插入回文档
selection.removeAllRanges(); // 清除当前选区
selection.addRange(range); // 重新选择新插入的span内容
});注意事项：document.execCommand 的局限性
document.execCommand 方法虽然实现简单，但它已被弃用（Deprecated），这意味着它可能在未来的浏览器版本中被移除或行为发生变化。此外，它的行为在不同浏览器之间可能存在不一致性，且对样式的精细控制能力有限。例如，fontSize 命令通常只接受1-7的整数值，对应预设的HTML字体大小，而无法直接设置像素值。对于更复杂的富文本编辑需求，建议采用更现代的Web API。
实现选中文本的字体大小调整
用户期望的字体大小调整功能通常是针对其选中的文本生效，而不是改变整个编辑区域的字体。由于document.execCommand('fontSize', ...)的局限性和弃用状态，我们将采用更灵活和现代的方法：利用 Selection 和 Range API。这种方法与实现文本高亮功能的核心思路是相同的。
核心思路
- 获取用户选择范围 (Selection)： 使用 window.getSelection() 获取当前用户选中的文本。
- 获取范围对象 (Range)： 从 Selection 对象中获取一个或多个 Range 对象，通常我们处理第一个 Range。
- 创建样式容器： 创建一个新的 元素，并设置其 style.fontSize 属性为用户期望的值。
-
提取内容并插入：
- 使用 range.extractContents() 将选中的内容从文档中取出。
- 将取出的内容添加到新创建的 元素中。
- 使用 range.insertNode() 将带有新字体大小的 元素插入回文档中原来选区的位置。
代码解释
在上述JavaScript代码中，fontSizeInput 的 input 事件监听器实现了这一逻辑：
fontSizeInput.addEventListener('input', function() {
const fontSize = this.value + 'px'; // 获取输入框的字体大小值，并加上'px'
const selection = window.getSelection();
if (!selection.rangeCount) {
// 如果没有选中任何文本，作为备用方案，将字体大小应用于整个编辑区域
// 这与Google Docs等应用的行为不同，它们通常只在无选区时应用到新输入的文本
userInput.style.fontSize = fontSize;
return;
}
const range = selection.getRangeAt(0);
const selectedText = range.extractContents(); // 提取选中的内容
const span = document.createElement("span");
span.style.fontSize = fontSize; // 设置span的字体大小
span.appendChild(selectedText); // 将提取的内容添加到span中
range.insertNode(span); // 将带有新字体大小的span插入回文档
selection.removeAllRanges(); // 清除当前选区
selection.addRange(range); // 重新选择新插入的span内容，以便用户可以继续编辑
});这段代码确保了当用户在可编辑区域内选中一部分文本并调整字体大小时，只有被选中的文本会受到影响。如果没有任何文本被选中，为了提供一个基础的反馈，它会将字体大小应用到整个编辑区域。在更复杂的编辑器中，没有选区时通常会将样式应用到光标所在位置，以便用户输入的新文本带有该样式。
文本高亮功能实现
高亮功能与字体大小调整的原理非常相似，都是通过 Selection 和 Range API 来包裹选中文本。
highlightBtn.addEventListener("click", function () {
const selection = window.getSelection();
if (!selection.rangeCount) return;
const range = selection.getRangeAt(0);
const span = document.createElement("span");
span.className = "highlight"; // 通过CSS定义 .highlight 类的背景色
span.appendChild(range.extractContents());
range.insertNode(span);
selection.removeAllRanges();
selection.addRange(range);
});此代码会获取当前选区，创建一个带有 highlight 类的 元素，将选中的内容移动到这个 中，然后将 插入回文档。通过CSS为 .highlight 类定义背景颜色，即可实现高亮效果。
document.execCommand 的替代方案与最佳实践
正如前文所述，document.execCommand 已经弃用，并且存在兼容性和功能限制。对于构建专业的富文本编辑器，推荐以下最佳实践：
-
利用 Selection 和 Range API： 这是Web标准提供的原生API，用于精确控制用户选择的文本范围。通过它们，你可以：
- 获取当前选区。
- 创建、修改或删除选区。
- 将HTML元素插入到选区中。
- 包裹或解开选区内的内容。
- 这些API提供了对文档内容更底层的控制，是实现复杂格式化功能的基石。
-
使用成熟的富文本编辑器库： 对于生产环境的应用，从头开始构建一个功能完备、兼容性良好且维护成本低的富文本编辑器是一项艰巨的任务。推荐使用业界成熟的开源库，例如：
- Quill: 一个现代、模块化的富文本编辑器，提供强大的API和自定义能力。
- TinyMCE: 功能丰富、高度可定制的所见即所得（WYSIWYG）编辑器，拥有庞大的社区支持。
- ProseMirror: 一个专注于构建复杂协作编辑器的工具包，提供了底层的编辑模型和视图管理。
这些库通常已经解决了跨浏览器兼容性、撤销/重做、粘贴处理、嵌套样式等复杂问题，能显著提高开发效率和产品质量。
总结
本文详细介绍了如何在Web应用中实现基础的文本格式化功能，并着重讲解了如何利用 Selection 和 Range API 来实现针对选中文本的字体大小调整和高亮功能。通过这种方式，我们可以避免使用已被弃用的 document.execCommand，从而构建出更健壮、更具扩展性的富文本编辑功能。对于更专业的应用场景，集成成熟的富文本编辑器库将是更明智的选择。掌握这些Web API是开发高级Web交互式应用的关键一步。
