JSS Dictionary API
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
多くの場合、多言語対応のアプリでは、翻訳が必要な静的フレーズのディクショナリが必要です。通常、これらは、フォーム ラベル、グローバル ナビゲーション アイテム、フッターなどのアイテムです。
Sitecore JavaScript レンダリング SDK (JSS) には、Sitecore ディクショナリ サービス を使用してアプリケーション固有の翻訳ディクショナリをフェッチするのに役立つ API が用意されています。
JSS を使用すると、データ フェッチの実装の詳細を気にすることなく、複数のエンドポイントからディクショナリ データを取得できます。JSS Dictionary API は、データ フェッチの実装の詳細を REST および GraphQL エンドポイントのサービス、クライアント、およびデータ フェッチャーに抽象化します。使用例を参照してください。
ディクショナリ データがフロントエンド アプリケーションで利用できるようになったら、その利用方法と、必要な国際化ライブラリを選択できます。たとえば、React JSS アプリケーションでは、カスタム プラグインでi18next モジュールを利用しています。
ディクショナリ データの Sitecore エンドポイント
Sitecore からディクショナリ フレーズをフェッチするためのいくつかのオプションがあります。
-
Sitecore ヘッドレス サービス が提供するREST ディクショナリ サービス エンドポイントを呼び出します。Sitecore ディクショナリ サービス エンドポイントは、アプリ固有のディクショナリ データを提供する REST エンドポイントです。
-
ヘッドレス サービスが提供する Sitecore Edge Preview GraphQL エンドポイントをクエリします。Sitecore Edge Preview GraphQL API は、Sitecore 上に GraphQL サーバーを実装したものです。Sitecore GraphQL スキーマは、Experience Edge スキーマを反映しています。
-
Sitecore Experience Edge for XM が提供する GraphQL エンドポイントをクエリします。Sitecore Experience Edge for XM には、ヘッドレス Sitecore 開発の一般的なフロントエンドのユース ケースに対応するように設計された読み取り専用の GraphQL スキーマが付属しています。Experience Edge スキーマを参照してください。
-
Sitecore GraphQL エンドポイントをクエリします。これは、JSS サーバー コンポーネントによって初めて導入された GraphQL エンドポイントです。このエンドポイントは、現在、React、Angular、および Vue サンプル アプリケーションのバージョン 18.0.0 以前でのみ使用されています。
JSS アプリケーションの作成時に、REST と GraphQL のどちらのエンドポイントを使用するかは、パラメーター --fetchWith REST または --fetchWith GraphQL で選択できます。