本文旨在提供一种在类似google Docs的富文本编辑器中，通过点击按钮向`fieldset`元素添加项目符号的方法。我们将探讨如何利用`execCommand`的`insertUnorderedList`命令，以及如何使用javaScript实现自定义的项目符号插入功能。
在构建类似google Docs的富文本编辑器时，一个常见需求是提供添加项目符号列表的功能。本文将介绍如何通过按钮点击事件，在fieldset元素中插入项目符号。
使用 execCommand 的 insertUnorderedList 命令
execCommand 是一个强大的 API，允许我们执行各种编辑操作。其中，insertUnorderedList 命令可以方便地插入一个无序列表。
html 结构：
<div class="buttons"> <button id="bulletPointBtn">•</button> </div> <fieldset class="userInput" contenteditable="true"></fieldset>
javascript 代码：
const bulletPointBtn = document.getElementById("bulletPointBtn"); const userInput = document.querySelector(".userInput"); bulletPointBtn.addEventListener("click", function() { document.execCommand("insertUnorderedList", false, NULL); });
这段代码首先获取按钮和 fieldset 元素的引用。然后，为按钮添加一个点击事件监听器。当按钮被点击时，document.execCommand(“insertUnorderedList”, false, null) 会在当前光标位置插入一个无序列表。 如果当前选中的是文本，则会将选中的文本放入一个列表中。
注意事项：
- contenteditable=”true” 属性必须添加到 fieldset 元素，才能使其可编辑。
- execCommand 的兼容性可能因浏览器而异，建议在使用前进行测试。
使用 JavaScript 实现自定义项目符号插入
如果 insertUnorderedList 命令不满足需求，或者需要更精细的控制，可以使用 JavaScript 实现自定义的项目符号插入功能。
JavaScript 代码：
const bulletPointBtn = document.getElementById("bulletPointBtn"); const userInput = document.querySelector(".userInput"); bulletPointBtn.addEventListener("click", function() { const selection = window.getSelection(); if (!selection.rangeCount) return; // 没有选中区域则返回 const range = selection.getRangeAt(0); const bullet = "u2022 "; // Unicode 项目符号 // 创建一个文本节点，包含项目符号和换行符 const bulletnode = document.createTextNode(bullet); const brNode = document.createElement("br"); // 将文本节点插入到选中区域的开始位置 range.insertNode(bulletNode); range.insertNode(brNode); // 将光标移动到新插入的项目符号后 range.collapse(false); // 折叠range到末尾 selection.removeAllRanges(); // 清空选择 selection.addRange(range); // 重新设置选择 });
这段代码首先获取当前选中的文本范围。然后，创建一个包含项目符号的文本节点，并将其插入到选中范围的开始位置。最后，将光标移动到新插入的项目符号后，以便用户可以继续输入。
代码解释：
- window.getSelection() 获取当前选中的文本。
- selection.getRangeAt(0) 获取选中文本的范围。
- u2022 是 Unicode 项目符号的表示。
- range.insertNode() 将节点插入到文档中。
- range.collapse(false) 将范围折叠到末尾，并将光标移动到该位置。
- selection.removeAllRanges() 清空当前的选择。
- selection.addRange(range) 将范围添加到选择中。
总结：
本文介绍了两种在富文本编辑器中通过按钮添加项目符号的方法：使用 execCommand 的 insertUnorderedList 命令和使用 JavaScript 实现自定义项目符号插入。选择哪种方法取决于具体的需求和对兼容性的考虑。使用 execCommand 更加简单，但自定义 JavaScript 实现提供了更大的灵活性。