配套高级插件变更

最后更新：2026-11-04 10:10:15

这些是 Tiny Cloud 和 TinyMCE Enterprise 的发行说明。如需了解 TinyMCE 最新社区版本的信息，请参阅 TinyMCE 更新日志。

概述

TinyMCE 8.1 于 2025 年 9 月 17 日（星期三）发布，适用于 TinyMCE Enterprise 和 Tiny Cloud。本发行说明概述了 TinyMCE 8.1 的变更内容，包括：

新增 Premium 插件
配套的 Premium 插件变更
改进
变更
Bug 修复
已弃用
已知问题

新增 Premium 插件

以下新增的 Premium 插件随 TinyMCE 8.1 一同发布。

全页 HTML (Full Page HTML)

新的 Premium 插件 全页 HTML 可全面控制文档元数据和属性。它允许用户通过直观的对话框界面编辑 HTML 文档元数据，如标题、关键词和描述。当与 code 插件结合使用时，它还可以在源代码视图中显示完整的 HTML 结构，包括 <head>、<body> 和各种 meta 标签。

有关 全页 HTML 插件的信息，请参阅全页 HTML。

配套的 Premium 插件变更

以下 Premium 插件更新随 TinyMCE 8.1 一同发布。

拼写检查器 (Spell Checker)

TinyMCE 8.1 版本包含了 拼写检查器 Premium 插件的配套版本。

拼写检查器 Premium 插件包含以下修复。

如果文档的第一个元素是 `noneditable`，拼写检查可能会创建无效的选区。

此前，当文档的第一个元素被设置为 contenteditable="false" (CEF) 元素时，使用 TinyMCE 拼写检查器选择所有内容可能会导致无效的选区状态。此问题阻碍了整个内容选区的删除，造成了一个破坏正常编辑工作流的边界情况。

为解决此问题，TinyMCE 现在会在此类场景中，在初始 CEF 元素之前插入一个临时隐藏元素。这一调整确保了全选操作有效，并能按预期删除内容。

有关 拼写检查器 插件的信息，请参阅：拼写检查器。

媒体优化器（由 Uploadcare 提供技术支持）(Media Optimizer Powered by Uploadcare)

TinyMCE 8.1 版本包含了 媒体优化器（由 Uploadcare 提供技术支持） Premium 插件的配套版本。

媒体优化器（由 Uploadcare 提供技术支持）包含以下修复。

图像预览有时会显示 `srcset` 中错误的图像。

在媒体优化器 Premium 插件的先前版本中，存在一个问题：图像效果是基于主 src 而非当前活动的 srcset URL 应用的。这导致当显示的图像是从 srcset 中选择时，会出现不一致。从而造成了调整预览（由主 src 渲染）与编辑器中显示的图像（由 srcset URL 渲染）不匹配，导致如模糊或缩放等效果的视觉呈现出现差异。

TinyMCE 8.1 通过使用 currentSrc 属性生成预览解决了此问题，确保了预览图像和编辑器中的图像引用的是同一资源。因此，预览图像与编辑器中的图像现在保持一致。

有关 媒体优化器（由 Uploadcare 提供技术支持）插件的信息，请参阅：媒体优化器（由 Uploadcare 提供技术支持）。

无障碍检查器 (Accessibility Checker)

TinyMCE 8.1 版本包含了 无障碍检查器 Premium 插件的配套版本。

无障碍检查器包含以下改进。

`alt` 文本长度错误消息现在会显示当前和最大字符数

在 无障碍检查器的先前版本中，alt 文本长度验证错误仅显示当前字符数，例如“当前为 151 个字符”，而未指明允许的最大长度。这给用户带来了不清晰的指引，并对所有依赖长度验证的图像规则 (I1–I4) 的体验产生了负面影响，使其与无障碍最佳实践不一致。

在 TinyMCE 8.1 中，无障碍检查器的错误消息已更新，会同时显示当前和最大字符数，例如：“151 个字符（最多允许 150 个）”。这一改进提供了清晰、可操作的错误提示，符合无障碍指南，并减少了用户在所有受影响规则下的困惑。

在图像修复对话框中，自动建议 `alt`、`aria-label` 和 `title` 属性中的现有文本，并提供优先级回退。

在 无障碍检查器的先前版本中，图像修复对话框仅建议使用 alt 属性中的值，忽略了 aria-label 和 title 属性，这迫使用户手动输入，拖慢了无障碍修复速度，并增加了描述不一致的风险。

TinyMCE 8.1 现在使用基于优先级的回退机制自动建议 alt 文本，依次检查现有属性 aria-labelledby、aria-label、alt 和 title，如果均不存在则将字段留空。这确保了用户能够通过利用现有的无障碍属性更快、更准确地标记图像，提高修复效率和一致性。

有关 Accessibility Checker 插件的信息，请参阅：Accessibility Checker。

修订历史

TinyMCE 8.1 版本包含 修订历史 高级插件的配套版本。

修订历史 包含以下修复和改进。

同一用户可能会收到两个不同的默认头像

在旧版修订历史插件中，同一用户可能会收到两个不同的默认头像。这种不一致会使同一用户显示为两个不同的贡献者，在查看修订日志时造成混淆。

在 TinyMCE 8.1 中，此问题已解决，现在每个用户始终会分配到相同的默认头像，提高了修订历史显示的准确性和一致性。

默认头像现在根据 `user_id` 以一致的颜色生成

默认头像现在使用 user_id 一致生成，确保用户被分配可靠且可预测的头像颜色。这一改进通过在修订历史中识别贡献者时提供清晰的视觉一致性，提升了用户体验。

有关 修订历史 插件的信息，请参阅：修订历史。

TinyMCE 8.1 版本包含评论高级插件的配套版本。

评论高级插件包含以下修复和改进。

默认头像生成不一致

此前，TinyMCE 在评论插件中生成默认头像的方式不一致。没有头像的用户在提及下拉列表中看到相同的占位头像，而同一用户在其他上下文中可能收到不同的默认头像。这种不一致导致难以区分用户，有时还会因同一用户显示为两个人而造成混淆。在 8.1 版本中，此问题已修复，默认头像现在基于 user_id 以稳定的颜色一致生成。这确保了同一用户始终拥有相同的默认头像，提高了清晰度并提供更可靠的用户体验。

在评论卡片中插入 `@Mention` 时评论下拉列表的键盘导航得到改进

此前，在评论卡片内输入 @ 打开提及下拉列表时，不支持 Shift+Enter 组合键。例如，在选定的评论卡片中输入 @ + 导航到用户后，按 Shift+Enter 无法将 @mention 插入评论正文的 <textarea>。

在 TinyMCE 8.1 中，此问题已解决，Shift+Enter 的处理方式与常规 Enter 键相同，确保在评论卡片内的 @mentions 下拉列表中选择项目时键盘交互一致且可预测。

有关评论插件的信息，请参阅：Tiny Comments 简介。

提及

TinyMCE 8.1 版本包含提及高级插件的配套版本。

提及高级插件包含以下改进。

没有头像的用户现在在提及下拉列表中显示头像占位符

此前，提及下拉列表未能正确处理用户没有个人资料头像的情况，导致用户界面视觉上不一致且不清晰。这影响了可用性，因为更难区分没有头像的用户和拥有不完整或损坏个人资料信息的用户。

在 TinyMCE 8.1 中，此问题已解决。现在，TinyMCE 为没有头像的用户提供默认头像占位符，确保在使用提及下拉列表时获得一致且完善的体验。

有关提及插件的信息，请参阅：提及。

AI 助手

TinyMCE 8.1 版本包含 AI 助手 高级插件的配套版本。

AI 助手 包含以下修复。

AI 助手插件对话框预览现在遵循 `content_security_policy` 编辑器选项

此前，AI 助手插件对话框预览未遵循 content_security_policy 编辑器选项，导致对加载外部资源（如图像）的控制受限。

在 TinyMCE 8.1 中，对话框预览现在在提供时应用配置的内容安全策略，确保根据编辑器的安全设置限制外部资源。这一改进增强了一致性，加强了安全性，并使插件符合 TinyMCE 中的用户定义策略。

有关 AI Assistant 插件的信息，请参阅：AI Assistant，或有关 content_security_policy 选项的信息，请参阅 Content Security Policy。

建议编辑 (Suggested Edits)

TinyMCE 8.1 版本包含 建议编辑 高级插件的配套发布版本。

建议编辑 包含以下修复和改进。

为建议编辑插件添加了键盘导航功能

建议编辑插件的初始版本不支持键盘导航，这限制了依赖键盘交互的用户的无障碍访问性。这种限制使得用户在不使用鼠标的情况下，很难在建议编辑侧边栏和卡片中移动并与之交互。为了提高可用性和无障碍访问性，建议编辑插件中已实现了键盘导航功能。用户现在可以使用键盘高效地导航并与插件进行交互。

空编辑器操作有时会显示为“已修改”而非“已添加/已删除”

以前，空的编辑器操作有时会错误地显示为“修改”，而不是“添加”或“删除”。这种行为会引起混淆，因为看起来为空的编辑器仍可能显示“已修改”状态。

为解决此问题，现在不再发送空内容。当编辑器为空或变为空时，整个状态现在被正确表示为“已添加”或“已删除”。这一改进确保了变更跟踪更加清晰和准确，减少了编辑器不包含内容时的混淆。

有关 建议编辑 插件的信息，请参阅：建议编辑。

改进

TinyMCE 8.1 还包含以下改进：

`editor.getContent()` 现在包含 `indent` 和 `entity_encoding` 属性以控制 HTML 格式

以前，在使用 TinyMCE getContent API 时，无法在调用过程中覆盖 indent 和 entity_encoding 等选项。编辑器总是应用其初始配置，这限制了内容检索时的灵活性。这意味着集成者被限制在初始化时设置的默认值上，无法按调用调整格式行为。

在 TinyMCE 8.1 中，getContent API 已得到增强，支持对 indent 和 entity_encoding 进行按调用覆盖。现在，在调用 getContent 时可以直接指定这些选项，无论编辑器的默认配置如何。这一改进使开发人员能够更好地控制输出格式，从而根据不同的用例定制内容检索。

示例：如何使用 getContent API 以不同的格式选项检索内容。

// 禁用缩进
tinymce.get(0).getContent({ indent: false });

// 使用命名实体进行序列化
tinymce.get(0).getContent({ indent: false, entity_encoding: 'named' });

// 使用数字实体进行序列化
tinymce.get(0).getContent({ indent: false, entity_encoding: 'numeric' });

// 将核心实体序列化为命名实体，其他序列化为数字实体
tinymce.get(0).getContent({ indent: false, entity_encoding: 'named+numeric' });

// 输出原始字符
tinymce.get(0).getContent({ indent: false, entity_encoding: 'raw' });

或

配置编辑器以使用命名实体编码并禁用缩进的示例。

tinymce.init({
  selector: "textarea",
  entity_encoding: 'named', // 或 'numeric' 或 'raw'
  indent: false, // 或 true
});

有关 getContent API 的更多信息，请参阅 getContent()。

当选择内容在屏幕外时，点击不可选择的元素不再滚动到选择内容位置

以前，存在一个问题：点击编辑器的水平滚动条这一“不可选择”的 UI 元素会隐式地聚焦编辑器，将光标置于内容开头，然后垂直滚动文档到该光标位置，导致页面滚动并偏离用户的当前视图。

TinyMCE 8.1 解决了这个问题。现在，当用户点击不可选择的元素（如滚动条）时，编辑器会避免获取焦点，从而防止意外的垂直滚动。

变更

TinyMCE 8.1 还包含以下变更：

工具提示现在可以在鼠标悬停时保持打开状态

以前，当光标从工具栏按钮移动到工具提示时，工具提示会消失，用户无法保持工具提示打开以供参考。这种行为影响了无障碍访问性，使依赖工具提示进行扩展阅读或导航的用户感到困难。在 8.1 版本中，TinyMCE 已更新以允许工具提示接受鼠标事件。这确保了工具提示在鼠标悬停时保持可见，通过允许用户保持工具提示打开直到他们移开光标，从而提高了无障碍访问性和可用性。

这一改进符合 WCAG 2.1 成功标准 1.4.13：悬停或聚焦时的内容 (AA 级)，特别是“可悬停”的要求。

错误修复

TinyMCE 8.1 还包含以下错误修复：

NVDA 会多次播报 iframe_aria_text

以前，在某些浏览器中，使用NVDA或JAWS等屏幕阅读器时，iframe_aria_text 要么根本不朗读，要么朗读两次，导致依赖辅助技术的用户遇到不一致且可能令人困惑的行为。为解决此问题，通过调整标签的应用方式，已将该行为标准化：

在 Firefox 中，title 属性现在直接设置在 iframe 元素上，且不使用 body 上的 aria-label。
而在其他浏览器中，aria-label 被应用到 iframe 内部的 body 上，而不在 iframe 上设置 title 属性。

因此，iframe_aria_text 现在在所有支持的浏览器中都能一致地朗读一次。

有关更多信息，请参阅：iframe_aria_text。

使用 `Command (CMD)` + `Backspace` 无法保留行内格式

以前，在行尾使用 Command (CMD) + Backspace 会删除整行而不保留行内格式，这与三击选中行后按 Backspace 的行为不同。这种不一致导致了混淆，因为不同的删除方法会产生不同的结果。

在 8.1 版本中，Command (CMD) + Backspace 的行为已更新以匹配其他删除方法，确保保留行内格式。

在 Firefox 中无法使用键盘在 `contenteditable="true"` 元素之间导航

在 TinyMCE 8.1 中，Firefox 特有的一个限制导致在使用键盘导航时，无法在可编辑元素之间移动光标。光标会被困在 figcaption 内部，阻止使用向下箭头键进行垂直导航，并使用户无法移动到下一个元素。

此问题破坏了依赖键盘交互的 Firefox 用户的无障碍访问和编辑流程。为解决此问题，引入了一个新的光标导航模块，并将其集成到 Firefox 特定的箭头键处理逻辑中。该解决方案通过编程方式将光标从受阻状态移出，规避了长期存在的 Firefox 错误，从而确保了在可编辑元素之间更顺畅、更一致的键盘导航。

选中 `figure` 后光标移动不正常

在 TinyMCE 的早期版本中，选中 figure 后使用 TAB 键将焦点移到 figcaption 元素时，会导致编辑器进入一种损坏状态：光标显示在 figcaption 内部，但输入时不会产生任何可见内容。此问题使用户无法仅使用键盘编辑 figcaption，迫使他们依赖鼠标或其他指向设备进行更改。

在 TinyMCE 8.1 中，此 bug 已修复，确保现在可以通过纯键盘导航无缝编辑 figcaption，提高了无障碍访问性和整体编辑效率。

使用 `&` 编码插入的链接现在会在插入前解码为 `&`

以前，将包含编码的 & 符号的 URL 粘贴到 TinyMCE 时，编码值会被保留，导致链接插入内容时出现双重编码。例如，粘贴的链接如

https://example.com/search?&amp;query=example

在编辑器源代码中会显示为

https://example.com/search?&amp;amp;query=example

这导致打开此类链接时出现问题，因为 URL 变得无效。在 8.1 版本中，TinyMCE 现在会在插入链接前自动将 & 解码回 &，确保粘贴的 URL 在编辑器和源代码中均保持有效和可用。

已弃用

TinyMCE 8.1 包含以下弃用项：

`content_css_cors` 配置选项已被弃用

从 TinyMCE 8.1 开始，content_css_cors 配置选项已被标记为已弃用。它将在即将发布的 TinyMCE 9.0 版本中被完全移除。作为替代，我们建议改用 crossorigin。

已知问题

本节描述 TinyMCE 8.1 用户可能遇到的问题及这些问题的可能解决方法。

TinyMCE 8.1 中有一个已知问题。

Full Page HTML 插件与 Suggested Edits 和 Revision History 不兼容

Full Page HTML 插件允许设置文档属性和元数据。然而，这些属性和元数据不会被 Suggested Edits 和 Revision History 插件识别，且在这些插件中执行的操作会覆盖由 Full Page HTML 插件设置的值。

解决方法： 避免将 Full Page HTML 插件与 Suggested Edits 或 Revision History 插件结合使用，以防止文档元数据和属性丢失。