Contribute to this guide

guide更新至 CKEditor 5 v30.x

更新 CKEditor 5 安装时,请确保所有软件包的版本都相同,以避免错误。

对于自定义版本,您可能尝试删除package-lock.jsonyarn.lock文件(如果适用)并重新安装所有软件包,然后再重新构建编辑器。为了获得最佳效果,请确保使用最新版本的软件包。

# 更新至 CKEditor 5 v30.0.0

发布日期:2021 年 9 月 29 日。

有关版本 30.0.0 中引入的所有更改列表,请参阅CKEditor 5 v31.0.0 的发布说明

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

# 视窗(工具栏)偏移配置更改

从 v30.0.0 开始,EditorConfig#toolbar.viewportTopOffset 配置已弃用。

新的EditorConfig#ui.viewportOffset 选项允许从每个方向设置viewportOffset

const config = {
    ui: {
        viewportOffset: { top: 10, right: 10, bottom: 10, left: 10 }
    }
}

以下是如何针对新的EditorConfig#ui.viewportOffset 配置更改进行适当集成的确切更改。

// Before v30.0.0.
ClassicEditor
    .create( ..., {
        // ...
        toolbar: {
            items: [ ... ],
            viewportTopOffset: 100
        }
    } )

// Since v30.0.0.
ClassicEditor
    .create( ..., {
        // ...
        toolbar: {
            items: [ ... ]
        },
        ui: {
            viewportOffset: {
                top: 100
            }
        }
    } )