CKEditor 5へのアップグレード
Liferay 2026.Q1+ リリース機能
CKEditor は、Web コンテンツやリッチテキストフィールドなど、さまざまなコンテキストで使用される Liferay の WYSIWYG テキストエディタです。 CKEditor 5は、Liferay DXPのリリース機能の一つで、編集エクスペリエンスとコンテンツのレンダリング方法を刷新するものです。
CKeditor 5 は、 Liferay CMS のデフォルトのテキストエディタです。 Liferay の他の場所で使用するには、 リリース機能フラグ LPD-11235 を有効にしてください。 CKEditor 4は2023年以降メンテナンスが終了しているため、メンテナンス上の問題を避けるためにもアップグレードを計画してください。 アップグレードの計画を立てたり、古いコンテンツに潜在的な問題がないかを確認したりするために、テスト環境でこの機能を有効にすることができます。
CKEditor 4からCKEditor 5にアップグレードすることには、多くの利点があります。
- これにより、他のツールとの間でシームレスなコピー＆ペースト操作が可能になります。
- これにより、Liferay DXPのリッチテキストエディタ全体で編集エクスペリエンスが標準化されます。
- コンテンツ編集者がページをスクロールダウンすると、編集ツールバーは常に表示されます。
- その他にも多数の新機能が追加されました！ CKEditor 5 のその他の機能ハイライトについては、 CKEditor の Web サイト を参照してください。
CKEditor 5へのアップグレードは、サイトの編集体験を大幅に向上させますが、既存のコンテンツに応じて慎重にアップグレードを計画する必要があります。
Liferay DXP 2025.Q3+ では、CKEditor 5 へのアップグレードは、Web コンテンツの Content および Description フィールドに適用されます。 バージョン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 は メディア埋め込み プラグインに依存しています。 |
機能の利用可能性
CKEditor 5
| Liferayのバージョン | 機能ステータス | 機能フラグラベル |
|---|---|---|
| Liferay DXP 2025.Q2 | ベータ | 拡張リッチテキストエディタ（LPD-11235） |
| Liferay DXP 2026.Q1 | リリース | 拡張リッチテキストエディタ（LPD-11235） |