更新至 CKEditor 5 v38.x

# 更新至 CKEditor 5 v38.1.0

于 2023 年 6 月 28 日发布。

有关 38.0.0 版本中引入的所有更改的完整列表，请参阅CKEditor 5 v38.1.0 的发行说明。

下面列出了升级到 CKEditor 5 v38.1.0 时需要您注意的次要重大更改。

# 通用 HTML 支持功能中的更改

CKEditor 5 版本 38.1.0 引入了一个次要重大更改。在此版本之前，通用 HTML 支持 (GHS) 插件将所有 HTML 特定的数据保留在htmlAttributes模型属性中，而不管元素类型如何。但是，这种方法难以确保属性不会泄漏到其他类型的元素。例如，如果您将某些样式应用于列表，您可能期望该列表中的新元素具有相同的样式，但您不希望它们出现在下一段或标题中。

GHS 过去以逐案的方式解决这个问题。但是，为了彻底解决这个问题，在此版本中，我们将htmlAttributes重命名为html*Attributes。*代表元素名称，例如htmlH1Attributes或htmlUlAttributes。这使该功能能够轻松确定给定属性是否在任何给定元素上都是允许的。

例如，htmlH1Attributes在H1元素上是允许的，但在段落元素上是不允许的。

升级到 CKEditor 5 v38.1.0 后，您需要相应地修改与 GHS 相关的代码，将所有htmlAttributes实例替换为相应视图元素的正确html*Attributes。

# 更新至 CKEditor 5 v38.0.0

于 2023 年 5 月 22 日发布。

有关 38.0.0 版本中引入的所有更改的完整列表，请参阅CKEditor 5 v38.0.0 的发行说明。

以下是升级到 CKEditor 5 v38.0.0 时需要您注意的最重要更改。

# 介绍“由 CKEditor 提供支持”徽标

从 38.0.0 版本开始，所有开源安装的 CKEditor 5 都将在编辑区域的右下角包含一个小小的“由 CKEditor 提供支持”徽标。此徽标旨在提高对 CKEditor 品牌的认识，并将链接到 CKEditor 网站。

如果您拥有商业许可证，可以通过在配置中添加config.licenseKey来隐藏徽标。如果您已经使用分页、生产力包或异步协作功能，则无需采取任何操作，因为您应该已经拥有config.licenseKey。徽标将不会在您的编辑器中显示。

我们准备了一份详细的管理“由 CKEditor 提供支持”徽标指南，以帮助所有人顺利过渡并解释任何疑虑。

# 在字体颜色和字体背景颜色功能中引入颜色选择器

从 v38.0.0 开始，字体颜色和字体背景颜色功能的用户界面将显示颜色选择器。新功能默认情况下已启用。它补充了现有的调色板，以改善编辑体验并提升内容作者的创造力。

但是，我们意识到，自由选择任何颜色可能会在一些与已配置调色板集成的内容中引入噪声和不一致。如果这是您的情况，您可以通过将colorPicker选项在其各自的配置中设置为false来禁用字体颜色和字体背景颜色功能中的颜色选择器。

ClassicEditor
    .create( document.querySelector( '#editor' ), {
        fontColor: {
            // Disable the color picker for the font color feature.
            colorPicker: false
        },
        fontBackgroundColor: {
            // Disable the color picker for the font background color feature.
            colorPicker: false
        },
        toolbar: [
            'heading', 'bulletedList', 'numberedList', 'fontColor', 'fontBackgroundColor', 'undo', 'redo'
        ]
    } )
    .then( /* ... */ )
    .catch( /* ... */ );