多言語サイトの翻訳可能なコンポーネントの開発
カスタム・コンポーネントの開発者は、カスタム・コンポーネント内のどの文字列を、多言語(MLS)サイトのページの翻訳で使用するかを指定できます。
これを実行するには、customSettingsData
オブジェクトにデータを保存する際に、最上位レベルにnls
プロパティを導入する必要があります。
たとえば:
SitesSDK.setProperty('customSettingsData', {
'nls': {
linkText: 'More...'
}
});
変換ジョブを作成すると、Oracle Content ManagementはcustomSettingsData
オブジェクトのトップレベル・プロパティをチェックし、ページ上のカスタム・コンポーネント・インスタンスごとにnls
オブジェクト全体をエクスポートします。 トランスレータはこれらの値を変換し、その後サイトにインポートできます。
サイト翻訳がインポートされると、翻訳されたロケール用に、nls
オブジェクトの正しいバージョンがcustomSettingsData
オブジェクトで返されます。
たとえば、サイトをフランス語に翻訳してから、フランス語ロケールでページをレンダリングした場合、カスタム・コンポーネントに渡されたcustomSettingsData
オブジェクトのnls
オブジェクトの値は次のように更新されます:
{
'nls': {
'linkText': 'Plus...'
}
},
customSettingsData
のnls
オブジェクトの形式は、名前と値のペアに限定する必要があります。 これにより翻訳が容易になり、翻訳済ロケールでページがレンダリングされるときに、サイトのベース値に翻訳済の値を正しく適用できます。