CKEditor 5へのアップグレード
Liferay 2025.Q2+ ベータ機能
現在、この機能は ベータ機能フラグ (LPD-11235) によってサポートされています。
CKEditor は、Web コンテンツやリッチ テキスト フィールドなどのさまざまなコンテキストで使用される Liferay の WYSIWYG テキスト エディターです。 CKEditor 5 は現在 Liferay DXP のベータ機能であり、編集エクスペリエンスとこれらの形式のコンテンツのレンダリング方法を刷新しています。
CKeditor 5 は現在アクティブにメンテナンスされているバージョンであり、2026 年の将来のリリースではデフォルトのテキスト エディターになる予定です。 CKEditor 4 は 2023 年時点でメンテナンスされなくなったため、メンテナンスの問題を回避するためにアップグレードを計画する必要があります。 テスト環境でこの機能を有効にすると、アップグレードの計画を立てたり、古いコンテンツに潜在的な問題がないか確認したりするのに役立ちます。
CKEditor 4 から CKEditor 5 にアップグレードすると、多くの利点があります。
- 他のツールとのシームレスなコピーアンドペーストが可能になります。
- Liferay DXP のリッチ テキスト エディター全体の編集エクスペリエンスを標準化します。
- コンテンツ編集者がページを下にスクロールすると、編集ツールバーが常に表示されます。
- さらに、さらに多くの新機能が追加されました。 CKEditor 5 のその他の機能のハイライトについては、 CKEditor Web サイト を参照してください。
CKEditor 5 にアップグレードすると、サイトの編集エクスペリエンスが大幅に向上しますが、既存のコンテンツに応じてアップグレードを慎重に計画する必要があります。
Liferay DXP 2025.Q3+では、CKEditor 5へのアップグレードは、Webコンテンツのコンテンツ および 説明フィールドに適用されます。 バージョン 2025.Q3 より前では、コンテンツ フィールドに CKEditor 5 のみを適用できます。
アップグレードに伴うリスク
CKEditor 5 の一部の変更は自動的にアップグレードされますが、HTML のレンダリング方法が異なるため、CKEditor 4 で作成された既存のコンテンツに影響する可能性があります。 アップグレード後に変更を行う前に、CKEditor 4 で作成したコンテンツをバックアップしてください。
LPD-11235 機能フラグ を有効にすると、CKEditor 5 のみが有効になります。 既存のコンテンツには CKEditor 4 で作成された HTML が含まれており、変更されていません。 コンテンツが影響を受けるのは、CKEditor 4 の古い HTML が含まれ、CKEditor 5 で編集した場合のみです。
さらに、CKEditor 4 で使用していた一部の機能は、CKEditor 5 で再度公開すると動作しなくなる可能性があります。
- 一部のプラグインは CKEditor 5 ではサポートされなくなりました。 CKEditor 5 の同等のプラグインについては、 公式チャート を参照してください。 CKEditor 5 で利用できる新しいプラグインは、あなたのユースケースにより適している可能性があります。
- CKEditor 4 用に作成されたカスタム プラグインは、プラグイン API が変更されたため、CKEditor 5 との互換性を保つためにアップグレードする必要があります。
- 埋め込まれたビデオ、表、またはスタイルは、CKEditor 5 では異なる方法で処理されるため、壊れる可能性があります。 2 つのバージョン間でどのコントロールが異なる HTML を生成するかの詳細については、 HTML バージョンの互換性 を参照してください。
- アップグレード前に作成されたスタイル付きテキストは、ツールバーのコントロールに応答しない可能性があります。
最も重要なことは、手動による介入なしに、CKEditor 4 の設定やプラグインを保持すると、CKEditor 5 で公開したときに古いコンテンツのデータが失われる可能性があることです。 CKEditor 5 を使用して公開するときに、コンテンツにこれらのケースのどれが当てはまるかを慎重に確認し、新しい最新のプラグインへのアップグレードを検討してください。
アップグレードの実行
アップグレードの手順については、 CKEditor の推奨移行戦略 を参照してください。 CKEditor 5 でコンテンツを読み込むには、LPD-11235 ベータ機能フラグ を有効にして編集します。 アップグレードがスムーズに行われるように、公開する前にテスト環境で機能を有効にして古いコンテンツを確認してください。
Liferay のさまざまなスタイルとページ レイアウト コンテキストによって、CKEditor で作成される HTML が異なるため、CKEditor 4 で作成されたすべての Web コンテンツ (コンテンツ フィールドと説明フィールド) を手動で確認し、CKEditor 5 で公開するときに変更され修正が必要なコンテンツがないか確認する必要があります。 アップグレードされたテキスト エディターで再度公開されるまで HTML は影響を受けないため、ワークフローに適したペースでコンテンツを確認できます。
古いコンテンツを確認する際には、特定の問題に対処するためのヘルプとして、 公式プラグイン チャート と HTML バージョン互換性テーブル を参照してください。
HTMLバージョンの互換性
CKEditor バージョン 4 と 5 は Liferay の多くのコントロールを共有していますが、アップグレード後に一部のコントロールでは HTML が異なります。 生成された HTML が変更された場合、正しい結果を確実に得るために手動の手順が必要になる場合があります。
Liferay の CKEditor 実装で使用されるすべてのコントロール (HTML を作成するもの) と、生成された HTML がこれらのバージョン間で同じかどうかは次のとおりです。
| コントロール | CKEditor 5 でも同じ HTML ですか? | 移行に関する注意事項 |
|---|---|---|
Bold | はい | |
BulletedList | はい | |
HorizontalRule | はい | |
ImageSelector | いいえ。CKEditor5 の img 要素には、 alt 属性や data-fileentryid 属性は含まれません。 | HTML の違いにもかかわらず、ページ上の結果は同じに表示されるため、追加の手順は必要ありません。 |
Italic | いいえ。CKEditor 4 の <em> タグは、CKEditor 5 では <i> タグになります。 | CKEditor 5 は、 <em> タグを <i> タグに自動的に変換するため、追加の手順は必要ありません。 |
JustifyCenter | はい | |
JustifyLeft | はい | |
JustifyRight | はい | |
Link | はい | |
NumberedList | はい | |
Styles | いいえ | スタイル CSS クラスが異なり、CKEditor 4 スタイルを選択してもコントロールは更新されません。 必要に応じて手動でスタイルを置き換えます。 |
Table | いいえ | CKEditor 5 は生のテーブル マークアップを自動的に変換しようとしますが、変換は複雑です。 必要に応じて、テーブルを手動で検証または再作成します。 |
Underline | はい | |
VideoSelector | いいえ | 埋め込みビデオは機能しなくなり、ページのレンダリングに問題が発生する可能性があります。 CKEditor 5 は メディア埋め込み プラグインに依存しています。 |