本文旨在解决tinymce富文本编辑器在使用`mceinsertcontent`命令插入html内容时，尤其是重复插入相同类型元素（如合并字段``标签）时，可能导致元素意外嵌套的问题。我们将探讨导致嵌套的原因，并提供一种结构化数据并迭代插入的解决方案，以确保插入的元素始终保持独立并作为兄弟元素存在，从而维护dom的整洁性和可预测性。
理解TinyMCE插入内容的默认行为
在使用TinyMCE的execCommand('mceInsertContent', false, htmlString)命令插入内容时，编辑器会将htmlString插入到当前光标所在的位置。如果连续多次调用此命令，且前一个插入的元素是一个可编辑的块级或行内块级元素，或者光标仍然停留在前一个元素的内部，那么后续插入的内容很可能会被嵌套到前一个元素中。
例如，当您尝试连续插入多个<em>标签作为合并字段时，如果每次插入后光标仍停留在前一个<em>标签内部，就会出现如下所示的嵌套结构：
<em class="Standard shortcode">[[Legal Full Name]]
<em class="Standard shortcode">[[ Company Address Country]]
<em class="DocumentSender shortcode">[[ Last Name]]</em>
</em>
</em>这种嵌套不仅不符合预期，还可能导致样式混乱、数据解析困难以及后续操作的复杂性。
解决方案：迭代插入独立元素
为了避免元素嵌套，核心策略是确保每次插入操作都将新内容放置在当前内容的外部，或者说，确保每次插入都是独立的。最有效的方法是预先组织好所有要插入的数据，然后通过循环迭代的方式，逐个将它们插入到编辑器中。
当TinyMCE执行mceInsertContent命令时，它通常会在插入内容后将光标移动到新插入内容的末尾（即其外部）。因此，如果我们将每个合并字段作为独立的HTML字符串进行插入，每次插入都会在当前光标位置（即前一个插入元素之后）创建一个新的兄弟元素，从而避免嵌套。
以下是实现此策略的示例代码：
// 准备要插入的合并字段数据，以数组形式结构化
var mergeFields = [
{
class: "Standard shortcode",
uniqueId: "ATK8N",
control: "merge-field",
text: "[[Legal Full Name]]"
},
{
class: "Standard shortcode",
uniqueId: "A8TI8",
control: "merge-field",
text: "[[Company Address Country]]"
},
{
class: "DocumentSender shortcode",
uniqueId: "HCFMG",
control: "merge-field",
text: "[[Last Name]]"
}
];
// 遍历数组，逐个插入合并字段
mergeFields.forEach(function(field) {
// 构建单个合并字段的HTML字符串
var wc = `<em class="${field.class}" data-unique-id="${field.uniqueId}" data-control="${field.control}">${field.text}</em>`;
// 调用TinyMCE命令插入内容
// 每次调用都插入一个独立的<em>元素
tinymce.get('document-template').execCommand('mceInsertContent', false, wc);
});通过上述代码，每次tinymce.get('document-template').execCommand('mceInsertContent', false, wc);调用都会插入一个完整的<em>元素。在第一个<em>元素插入后，TinyMCE的光标会移动到它的右侧。接着，第二个<em>元素会在新的光标位置插入，成为第一个<em>元素的兄弟。依此类推，最终生成的HTML结构将是：
<em class="Standard shortcode" data-unique-id="ATK8N" data-control="merge-field">[[Legal Full Name]]</em> <em class="Standard shortcode" data-unique-id="A8TI8" data-control="merge-field">[[ Company Address Country]]</em> <em class="DocumentSender shortcode" data-unique-id="HCFMG" data-control="merge-field">[[ Last Name]]</em>
这正是我们期望的非嵌套、独立的元素结构。
注意事项与最佳实践
- 数据结构化： 将需要插入的复杂数据组织成数组或对象数组，是实现迭代插入的基础。这不仅使代码更清晰，也便于管理和扩展。
- 光标位置： mceInsertContent命令的插入行为与当前光标位置密切相关。确保在插入前，光标处于期望的位置。在上述迭代场景中，TinyMCE会自动处理光标的移动，确保连续插入的独立性。
- 性能考量： 对于少量或中等数量的元素插入，迭代方式是高效且可行的。如果需要一次性插入大量（例如数百个）复杂元素，可以考虑先在JavaScript中构建完整的HTML字符串，然后一次性通过mceInsertContent插入。然而，对于本例中的<em>标签，迭代插入通常不会有显著的性能问题。
- 用户体验： 考虑用户是希望一次性插入所有合并字段，还是逐个插入。如果是一次性插入，上述迭代方法会将所有字段连续地插入到当前光标位置。
- 其他插入方法： TinyMCE还提供了其他操作DOM的方法，例如editor.dom.add()或直接操作iframe内容。但在大多数情况下，mceInsertContent结合正确的策略足以满足插入需求。
总结
当在TinyMCE富文本编辑器中插入多个类似元素时，为避免不必要的嵌套，最有效的策略是将要插入的数据进行结构化，并通过迭代的方式逐个调用mceInsertContent命令。这种方法利用了TinyMCE在每次插入后自动调整光标位置的特性，确保每个元素都能作为独立的兄弟节点插入，从而维护DOM的整洁和可预测性。遵循此方法，可以有效解决因连续插入操作导致的元素嵌套问题。
