Office アドインのローカライズ

[アーティクル]
10/11/2023

Office アドインに適切なローカライズ方法を任意に選んで実装できます。 JavaScript API と Office アドインプラットフォームのマニフェストスキーマには、いくつかの選択肢が用意されています。 Office JavaScript API を使用すると、Office アプリケーションのロケールに基づいてロケールを決定し、文字列を表示したり、データのロケールに基づいてデータを解釈または表示したりできます。マニフェストを使用すると、ロケールに固有なアドインファイルの場所と説明的な情報を指定できます。または、Visual Studio と Microsoft Ajax スクリプトを使用して、グローバリゼーションとローカライズをサポートすることもできます。

ロケール固有文字列を判別するための JavaScript API の使用

Office JavaScript API には、Office アプリケーションとデータのロケールと一致する値の表示または解釈をサポートする 2 つのプロパティが用意されています。

Context.displayLanguage は、Office アプリケーションのユーザーインターフェイスのロケール (または言語) を指定します。次の例では、Office アプリケーションが en-US または fr-FR ロケールを使用しているかどうかを確認し、ロケール固有のあいさつ文を表示します。

function sayHelloWithDisplayLanguage() {
    const myLanguage = Office.context.displayLanguage;
    switch (myLanguage) {
        case 'en-US':
            write('Hello!');
            break;
        case 'fr-FR':
            write('Bonjour!');
            break;
    }
}

// Function that writes to a div with id='message' on the page.
function write(message) {
    document.getElementById('message').innerText += message;
}

Context.contentLanguage は、データのロケール (または言語) を指定します。 displayLanguage プロパティを確認する代わりに、最後のコードサンプルを拡張し、contentLanguage プロパティの値を割り当てmyLanguage、同じコードの残りの部分を使用して、データのロケールに基づいてあいさつ文を表示します。
```
const myLanguage = Office.context.contentLanguage;
```

マニフェストでのローカライズの制御

マニフェストを使用してローカライズする手法は、Xml マニフェストを使用しているか、Outlook for Windows でのみサポートされている Microsoft 365 (プレビュー) の統合マニフェストを使用しているかによって異なります。

XML マニフェスト
統合マニフェスト (開発者プレビュー)

すべての Office アドインは、そのマニフェストで DefaultLocale 要素とロケールを指定します。既定では、Office アドインプラットフォームと Office クライアントアプリケーションは、 Description、 DisplayName、 IconUrl、 HighResolutionIconUrl、 SourceLocation 要素の値をすべてのロケールに適用します。必要に応じて、これらの 5 つの要素のいずれかに対して、追加のロケールごとに Override 子要素を指定することで、特定のロケールの特定の値をサポートできます。 DefaultLocale 要素の値と LocaleOverride 要素の属性の値は、RFC 3066「言語の識別のタグ」に従って指定されます。表 1 に、これらの要素のローカライズサポートについて説明します。

表 1. ローカライズのサポート

要素	ローカライズのサポート
Description	指定した各ロケールのユーザーには、AppSource (またはプライベートカタログ) でローカライズされたアドインの説明が表示されます。 Outlook アドインについては、アドインのインストール後に Exchange 管理センター (EAC) に表示される説明が該当します。
DisplayName	指定した各ロケールのユーザーには、AppSource (またはプライベートカタログ) でローカライズされたアドインの説明が表示されます。 Outlook アドインについては、アドインのインストール後に [Outlook アドイン] ボタンのラベルおよび EAC に表示される表示名が該当します。コンテンツアドインと作業ウィンドウアドインの場合、ユーザーはアドインのインストール後にリボンに表示名を表示できます。
IconUrl	アイコンのイメージは省略可能です。ここで説明したオーバーライドと同じ方法で、特定のカルチャに特定のイメージを指定できます。アイコンを使用し、ローカライズした場合、指定した各ロケールのユーザーには、アドインのローカライズされたアイコン画像が表示されます。 Outlook アドインについては、アドインのインストール後に EAC で表示されるアイコンが該当します。コンテンツアドインと作業ウィンドウアドインの場合、ユーザーはアドインのインストール後にリボンにアイコンを表示できます。
HighResolutionIconUrl重要: この要素は、アドインマニフェストのバージョン 1.1 を使用する場合にのみ使用できます。	高解像度のアイコンのイメージは省略可能ですが、指定する場合は、IconUrl 要素の後に指定する必要があります。 HighResolutionIconUrl が指定され、高解像度の dpi をサポートするデバイスにアドインがインストールされている場合、IconUrl の値の代わりに HighResolutionIconUrl の値が使用されます。ここで説明したオーバーライドと同じ方法で、特定のカルチャに特定のイメージを指定できます。アイコンを使用し、ローカライズした場合、指定した各ロケールのユーザーには、アドインのローカライズされたアイコン画像が表示されます。 Outlook アドインについては、アドインのインストール後に EAC で表示されるアイコンが該当します。コンテンツアドインと作業ウィンドウアドインの場合、ユーザーはアドインのインストール後にリボンにアイコンを表示できます。
Resources重要: この要素は、アドインマニフェストのバージョン 1.1 を使用する場合にのみ使用できます。	指定した各ロケールのユーザーには、そのロケールのアドイン専用に作成した文字列とアイコンリソースが表示されます。
SourceLocation	指定した各ロケールのユーザーには、そのロケールのアドイン専用にデザインした Web ページが表示されます。

注:

Office がサポートするロケールでのみ、説明と表示名をローカライズできます。現在のリリースの Office の言語とロケールの一覧については、「Microsoft 365 Appsの言語の展開の概要」を参照してください。

例

たとえば、Office アドインで DefaultLocale を en-us に指定できます。次に示すように、アドインは、DisplayName 要素に対して、ロケールがの fr-fr 子要素を指定できます。

<DefaultLocale>en-us</DefaultLocale>
...
<DisplayName DefaultValue="Video player">
    <Override Locale="fr-fr" Value="Lecteur vidéo" />
</DisplayName>

注:

de-de や de-at など、言語ファミリ内の複数の領域用にローカライズを行う必要がある場合は、領域ごとに別々の Override 要素を使用することをお勧めします。この場合、言語名のみを使用することは、 deOffice クライアントアプリケーションとプラットフォームのすべての組み合わせでサポートされるわけではありません。

これは、アドインが既定でロケールを en-us 前提としていることを意味します。クライアントコンピューターのロケールがである場合を除き、すべてのロケールに対して "Video player" の英語表示名が表示されます。この場合、ユーザーには fr-frフランス語の表示名 "Lecteur vidéo" が表示されます。

注:

既定のロケールを含め、1 つの言語につき 1 つの override のみを指定できます。たとえば、既定のロケールがである場合、 en-us オーバーライド en-us も指定できません。

次の例では、 Description 要素のロケールオーバーライドを適用します。最初にの既定のロケールと英語の en-us 説明を指定し、次にロケールのフランス語の説明を持つ Override ステートメントを fr-fr 指定します。

<DefaultLocale>en-us</DefaultLocale>
...
<Description DefaultValue=
   "Watch YouTube videos referenced in the emails you receive
   without leaving your email client.">
   <Override Locale="fr-fr" Value=
   "Visualisez les vidéos YouTube référencées dans vos courriers 
   électronique directement depuis Outlook."/>
</Description>

これは、アドインが既定でロケールを en-us 前提としていることを意味します。クライアントコンピューターのロケールがである DefaultValue 場合を除き、すべてのロケールの属性に英語の説明が表示されます。この場合、 fr-frフランス語の説明が表示されます。

次の例では、アドインで、ロケールとカルチャに適した別のイメージを fr-fr 指定しています。クライアントコンピューター fr-frのロケールがである場合を除き、ユーザーは既定でイメージ DefaultLogo.pngを表示します。この場合、ユーザーにはイメージ FrenchLogo.pngが表示されます。

<!-- Replace "domain" with a real web server name and path. -->
<IconUrl DefaultValue="https://<domain>/DefaultLogo.png"/>
<Override Locale="fr-fr" Value="https://<domain>/FrenchLogo.png"/>

次の例は、セクションでリソースをローカライズする方法を Resources 示しています。カルチャに適したイメージのローカル式を適用しています。

<Resources>
      <bt:Images>
        <bt:Image id="icon1_16x16" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp16-icon_default.png" />
        </bt:Image>
 ...

SourceLocation 要素については、他のロケールをサポートする場合、該当する各ロケール用のソース HTML ファイルを個別に用意する必要があります。指定した各ロケールのユーザーには、そのロケール用にカスタマイズしてデザインした Web ページが表示されます。

Outlook アドインの場合、 SourceLocation 要素もフォームファクターに合わせて配置されます。これにより、対応するフォームファクターごとに個別のローカライズされたソース HTML ファイルを提供できます。適用できる各設定要素 (DesktopSettings、TabletSettings、または PhoneSettings) で、1 つ以上の Override 子要素を指定できます。次の例は、デスクトップ、タブレット、スマートフォンのフォームファクターの設定要素を示しています。それぞれに、既定のロケール用の HTML ファイルとフランス語ロケール用の別の HTML ファイルがあります。

<DesktopSettings>
   <SourceLocation DefaultValue="https://contoso.com/Desktop.html">
      <Override Locale="fr-fr" Value="https://contoso.com/fr/Desktop.html" />
   </SourceLocation>
   <RequestedHeight>250</RequestedHeight>
</DesktopSettings>
<TabletSettings>
   <SourceLocation DefaultValue="https://contoso.com/Tablet.html">
      <Override Locale="fr-fr" Value="https://contoso.com/fr/Tablet.html" />
   </SourceLocation>
   <RequestedHeight>200</RequestedHeight>
</TabletSettings>
<PhoneSettings>
   <SourceLocation DefaultValue="https://contoso.com/Mobile.html">
      <Override Locale="fr-fr" Value="https://contoso.com/fr/Mobile.html" />
   </SourceLocation>
</PhoneSettings>

統合マニフェスト (プレビュー) を使用する場合は、「アプリマニフェストの文字列をローカライズする」で説明されているように、マニフェスト内の公開文字列をローカライズします。 Outlook アドインの例を次に示します。 1 つ目は、マニフェスト内の "localizationInfo" オブジェクトです。以下は、翻訳された文字列を含む fr-fr.json ファイルです。アドインには、作業ウィンドウ (フランス語バージョンのホームページあり)、ローカライズされたフランス語のアイコン、およびダイアログボックスでビデオプレーヤーを開くカスタムリボンボタンがあります。

"localizationInfo": {
  "defaultLanguageTag": "en",
  "additionalLanguages": [
    {
      "languageTag": "fr-fr",
      "file": "fr-fr.json"
    }
  ]
}

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.Localization.schema.json",
  "name.short": "Lecteur vidéo",
  "name.full": "Lecteur vidéo pour Outlook",
  "description.short": "Voir les vidéos YouTube dans Outlook via les mails.",
  "description.full": "Visualisez les vidéos YouTube référencées dans vos courriers électronique directement depuis Outlook.",
  "icons.color": "https://localhost:3000/assets/fr-fr/icon-128.png",
  "extensions[0].audienceClaimUrl": "https://localhost:3000/fr-fr/taskpane.html",
  "extensions[0].ribbons[0].tabs[0].groups[0].label": "Outils de médias",
  "extensions[0].ribbons[0].tabs[0].groups[0].controls[0].icons[0].url": "https://localhost:3000/assets/fr-fr/player-icon.png",
  "extensions[0].ribbons[0].tabs[0].groups[0].controls[0].label": "Ouvrir le lecteur vidéo",
  "extensions[0].ribbons[0].tabs[0].groups[0].controls[0].supertip.description": "Cliquez pour ouvrir le lecteur vidéo.",
  "extensions[0].ribbons[0].tabs[0].groups[0].controls[0].supertip.title": "Ouvrir le lecteur vidéo",
}

拡張オーバーライドをローカライズする

注:

統合マニフェスト (プレビュー) を使用している場合、このセクションは適用されません。

キーボードショートカットなど、Office アドインの機能拡張機能の一部は、アドインの XML マニフェストではなく、サーバーでホストされている JSON ファイルで構成されます。このセクションでは、拡張オーバーライドについて理解していることを前提としています。「マニフェストと ExtendedOverrides 要素の拡張オーバーライドを処理する」を参照してください。

ResourceUrlExtendedOverrides 要素の属性を使用して、ローカライズされたリソースのファイルを Office にポイントします。次に例を示します。

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json" 
                       ResourceUrl="https://contoso.com/addin/my-resources.json">
    </ExtendedOverrides>
</OfficeApp>

拡張オーバーライドファイルでは、文字列の代わりにトークンが使用されます。トークンは、リソースファイル内の文字列に名前を付けます。アドインの作業ウィンドウを表示する関数 (他の場所で定義) にキーボードショートカットを割り当てる例を次に示します。このマークアップに関する注意:

この例は非常に有効ではありません。 (必要な追加プロパティを以下に追加します)。
トークンの形式は ${resource である必要があります。name-of-resource}。

{
    "actions": [
        {
            "id": "SHOWTASKPANE",
            "type": "ExecuteFunction",
            "name": "${resource.SHOWTASKPANE_action_name}"
        }
    ],
    "shortcuts": [
        {
            "action": "SHOWTASKPANE",
            "key": {
                "default": "${resource.SHOWTASKPANE_default_shortcut}"
            }
        }
    ] 
}

JSON 形式のリソースファイルには、最上位の resources プロパティがあり、ロケールによってサブプロパティに分割されます。ロケールごとに、拡張オーバーライドファイルで使用された各トークンに文字列が割り当てられます。との文字列en-usfr-frがある例を次に示します。この例では、キーボードショートカットは両方のロケールで同じですが、特にアルファベットや書き込みシステムが異なるロケールで異なるキーボードをローカライズする場合は、必ずしもそうは限りません。

{
    "resources":{ 
        "en-us": { 
            "SHOWTASKPANE_default_shortcut": { 
                "value": "CTRL+SHIFT+A", 
            }, 
            "SHOWTASKPANE_action_name": {
                "value": "Show task pane for add-in",
            }, 
        },
        "fr-fr": { 
            "SHOWTASKPANE_default_shortcut": { 
                "value": "CTRL+SHIFT+A", 
            }, 
            "SHOWTASKPANE_action_name": {
                "value": "Afficher le volet de tâche pour add-in",
              } 
        }
    }
}

ファイルには、セクションと fr-fr セクションのen-usピアであるプロパティはありませんdefault。これは、Office ホストアプリケーションのロケールがリソースファイル内の ll-cc プロパティと一致しない場合に使用される既定の文字列を、 拡張オーバーライドファイル自体で定義する必要があるためです。拡張オーバーライドファイルで既定の文字列を直接定義すると、Office アプリケーションのロケールがアドインの既定のロケール (マニフェストで指定されている) と一致する場合に、Office がリソースファイルをダウンロードできなくなります。次に、リソーストークンを使用する拡張オーバーライドファイルの前の例の修正版を示します。

{
    "actions": [
        {
            "id": "SHOWTASKPANE",
            "type": "ExecuteFunction",
            "name": "${resource.SHOWTASKPANE_action_name}"
        }
    ],
    "shortcuts": [
        {
            "action": "SHOWTASKPANE",
            "key": {
                "default": "${resource.SHOWTASKPANE_default_shortcut}"
            }
        }
    ],
    "resources": { 
        "default": { 
            "SHOWTASKPANE_default_shortcut": { 
                "value": "CTRL+SHIFT+A", 
            }, 
            "SHOWTASKPANE_action_name": {
                "value": "Show task pane for add-in",
            } 
        }
    }
}

日付/時刻の形式のクライアントロケールへの関連付け

displayLanguage プロパティを使用して、Office クライアントアプリケーションのユーザーインターフェイスのロケールを取得できます。その後、Office アプリケーションの現在のロケールと一致する形式で日付と時刻の値を表示できます。その方法の 1 つが、Office アドインがサポートする各ロケールで使用する日付と時刻の表示形式を指定したリソースファイルを準備するという方法です。実行時に、アドインはリソースファイルを使用し、適切な日付/時刻形式を displayLanguage プロパティから取得したロケールと一致させることができます。

contentLanguage プロパティを使用して、Office クライアントアプリケーションのデータのロケールを取得できます。この値に基づいて、日付と時刻の文字列を適切に変換または表示できます。たとえば、jp-JP ロケールでは日付と時刻の値は yyyy/MM/dd と表記され、fr-FR ロケールでは dd/MM/yyyy と表記されます。

Visual Studio を使用してローカライズおよびグローバル化されたアドインを作成する

Visual Studio で Office アドインを作成する場合, .NET Framework と Ajax を使用してクライアントスクリプトファイルをグローバライズおよびローカライズできます。

現在のブラウザーのロケール設定に基づいて値を表示するには、Office アドイン向けの JavaScript コード内で Date および Number JavaScript 型の拡張と JavaScript Date オブジェクトをグローバライズして使用できます。詳細については、「 Walkthrough: Globalizing a Date by Using Client Script」を参照してください。

ローカライズされたリソース文字列をスタンドアロンの JavaScript ファイルに直接含めて、ブラウザーで設定されている、またはユーザーによって提供されるさまざまなロケールのクライアントスクリプトファイルを提供できます。サポートされているロケールごとに個別のスクリプトファイルを作成します。各スクリプトファイルに、そのロケールのリソース文字列を含む JSON 形式のオブジェクトを含めます。ローカライズされた値は、スクリプトがブラウザーで実行されるときに適用されます。

例: ローカライズされた Office アドインの作成

このセクションでは、Office アドインの説明、表示名、および UI をローカライズする方法の例を示します。

注:

Visual Studio をダウンロードするには、 Visual Studio IDE ページを参照してください。インストール時には、Office/SharePoint 開発ワークロードを選択する必要があります。

表示または編集用の追加言語を使用できるように Office を構成する

指定したサンプルコードを実行するには、メニューとコマンドの表示、編集と校正、またはその両方に使用する言語を切り替えてアドインをテストできるように、追加の言語を使用するようにコンピューター上の Office を構成します。

Office Language Pack を使用して、追加言語をインストールできます。言語パックの詳細と入手先については、「Office 2013 の言語オプション」を参照してください。

Language Accessory Pack をインストールしたら、UI の表示、ドキュメントコンテンツの編集、またはその両方にインストールされた言語を使用するように Office を構成できます。この記事の例では、言語パック (スペイン語) が適用されている Office のインストールを使用します。

Office アドインプロジェクトの作成

Visual Studio Office アドインプロジェクトを作成する必要があります。

注:

Visual Studio をインストールしていない場合は、ダウンロード手順については、 Visual Studio IDE ページを参照してください。インストール時には、Office/SharePoint 開発ワークロードを選択する必要があります。以前に Visual Studio 2019 以降をインストールしている場合は、Visual Studio インストーラーを使用して Office/SharePoint 開発ワークロードがインストールされていることを確認します。

[新規プロジェクトの作成] を選択します。
検索ボックスを使用して、アドインと入力します。 [Word Web アドイン] を選択し、[次へ] を選択します。
プロジェクトに WorldReadyAddIn という名前を付け、[ 作成] を選択します。
ソリューションが Visual Studio によって作成され、2 つのプロジェクトがソリューションエクスプローラーに表示されます。 Home.html ファイルが Visual Studio で開きます。

アドインに使用されるテキストのローカライズ

別の言語用にローカライズするテキストが 2 つの領域に表示されます。

アドインの表示名と説明 。これは、アドインのマニフェストファイルのエントリによって制御されています。
アドイン UI。アドインの UI に表示される文字列は、JavaScript コードを使用してローカライズできます。たとえば、ローカライズされた文字列を含む別個のリソースファイルを使用します。

アドインの表示名と説明をローカライズする

ソリューションエクスプローラーで、WorldReadyAddIn、WorldReadyAddInManifest の順に展開し、WorldReadyAddIn.xml を選択します。
WorldReadyAddInManifest.xmlで、 DisplayName 要素と Description 要素を次のコードブロックに置き換えます。

注:

この例の DisplayName 要素および Description 要素で使用されているスペイン語にローカライズされた文字列を、別の言語にローカライズされた文字列で置き換えることができます。
```
<DisplayName DefaultValue="World Ready add-in">
  <Override Locale="es-es" Value="Aplicación de uso internacional"/>
</DisplayName>
<Description DefaultValue="An add-in for testing localization">
  <Override Locale="es-es" Value="Una aplicación para la prueba de la localización"/>
</Description>
```
たとえば、Microsoft 365 の表示言語を英語からスペイン語に変更し、アドインを実行すると、アドインの表示名と説明がローカライズされたテキストで表示されます。

アドイン UI をレイアウトする

Visual Studio のソリューションエクスプローラーで、Home.html を選択します。

Home.html で <body> 要素コンテンツを次の HTML に置き換えて、ファイルを保存します。

<body>
    <!-- Page content -->
    <div id="content-header" class="ms-bgColor-themePrimary ms-font-xl">
        <div class="padding">
            <h1 id="greeting" class="ms-fontColor-white"></h1>
        </div>
    </div>
    <div id="content-main">
        <div class="padding">
            <div class="ms-font-m">
                <p id="about"></p>
            </div>
        </div>
    </div>
</body>

次の図は、残りの手順を完了してアドインを実行したときにローカライズされたテキストが表示される見出し (h1) 要素と段落 (p) 要素を示しています。

図 1. アドインの UI

セクションが強調表示されたアプリのユーザーインターフェイス。

ローカライズされた文字列を含むリソースファイルの追加

JavaScript リソースファイルには、アドイン UI に使用された文字列が含まれます。サンプルアドイン UI の HTML には、あいさつ文を表示する <h1> 要素、およびユーザーにアドインを紹介する <p> 要素が含まれます。

見出しと段落のローカライズされた文字列を有効にするには、文字列を別個のリソースファイルに置きます。このリソースファイルにより、ローカライズされた文字列の各セット用に個別の JavaScript Object Notation (JSON) オブジェクトを格納する JavaScript オブジェクトが作成されます。また、指定したロケールに対する適切な JSON オブジェクトを取得するためのメソッドも提供されます。

リソースファイルをアドインプロジェクトに追加する

Visual Studio のソリューションエクスプローラーで、WorldReadyAddInWeb プロジェクトを右クリックして [追加]>[新しい項目] を選択します。
[新しい項目の追加] ダイアログボックスで [JavaScript ファイル] を選択します。
ファイル名として「UIStrings.js」と入力して、[追加] を選択します。

次のコードを UIStrings.js ファイルに追加して、ファイルを保存します。

/* Store the locale-specific strings */

const UIStrings = (function ()
{
    "use strict";

    const UIStrings = {};

    // JSON object for English strings
    UIStrings.EN =
    {
        "Greeting": "Welcome",
        "Introduction": "This is my localized add-in."
    };

    // JSON object for Spanish strings
    UIStrings.ES =
    {
        "Greeting": "Bienvenido",
        "Introduction": "Esta es mi aplicación localizada."
    };

    UIStrings.getLocaleStrings = function (locale)
    {
        let text;

        // Get the resource strings that match the language.
        switch (locale)
        {
            case 'en-US':
                text = UIStrings.EN;
                break;
            case 'es-ES':
                text = UIStrings.ES;
                break;
            default:
                text = UIStrings.EN;
                break;
        }

        return text;
    };

    return UIStrings;
})();

UIStrings.js リソースファイルで、アドインの UI のローカライズされた文字列を含むオブジェクト UIStrings を作成します。

アドインの UI に使用するテキストのローカライズ

アドインでリソースファイルを使用するには、リソースファイルのスクリプトタグを Home.html に追加する必要があります。 Home.html が読み込まれると、UIStrings.js が実行され、文字列の取得に使用する UIStrings オブジェクトをコードで利用できるようになります。コードで UIStrings を利用できるようにするには、Home.html の head タグに次の HTML を追加します。

<!-- Resource file for localized strings: -->
<script src="../UIStrings.js" type="text/javascript"></script>

これで、UIStrings オブジェクトを使用してアドインの UI の文字列を設定できるようになりました。

Office クライアントアプリケーションのメニューやコマンドに表示するために使用する言語に基づいてアドインのローカライズを変更する場合は、 Office.context.displayLanguage プロパティを使用してその言語のロケールを取得します。たとえば、アプリケーション言語でメニューやコマンドの表示にスペイン語を使用する場合、 Office.context.displayLanguage プロパティは言語コード es-ES を返します。

ドキュメントコンテンツの編集に使用されている言語に基づいてアドインのローカライズを変更する場合は、 Office.context.contentLanguage プロパティを使用してその言語のロケールを取得します。たとえば、アプリケーション言語でドキュメントコンテンツの編集にスペイン語を使用する場合、 Office.context.contentLanguage プロパティは言語コード es-ES を返します。

アプリケーションが使用している言語がわかったら、 UIStrings を使用して、アプリケーション言語に一致するローカライズされた文字列のセットを取得できます。

Home.js ファイルのコードを次のコードで置き換えます。このコードは、アプリケーションの表示言語またはアプリケーションの編集言語に基づいて、Home.htmlの UI 要素で使用される文字列を変更する方法を示しています。

注:

編集に使用する言語に基づいてアドインのローカライズの変更を切り替えるには、コード行のコメントを解除し、コード const myLanguage = Office.context.contentLanguage; 行をコメントアウトします。 const myLanguage = Office.context.displayLanguage;

/// <reference path="../App.js" />
/// <reference path="../UIStrings.js" />


(function () {
    "use strict";

    // The initialize function must be run each time a new page is loaded.
    Office.initialize = function (reason)
    {

        $(document).ready(function () {
            // Get the language setting for editing document content.
            // To test this, uncomment the following line and then comment out the
            // line that uses Office.context.displayLanguage.
            // const myLanguage = Office.context.contentLanguage;

            // Get the language setting for UI display in the Office application.
            const myLanguage = Office.context.displayLanguage;
            let UIText;

            // Get the resource strings that match the language.
            // Use the UIStrings object from the UIStrings.js file
            // to get the JSON object with the correct localized strings.
            UIText = UIStrings.getLocaleStrings(myLanguage);

            // Set localized text for UI elements.
            $("#greeting").text(UIText.Greeting);
            $("#about").text(UIText.Introduction);
        });
    };
})();

ローカライズされたアドインのテスト

ローカライズされたアドインをテストするには、Office アプリケーションでの表示または編集に使用する言語を変更してから、アドインを実行します。

Word で [ファイル]、[オプション]、[言語] の順に選択します。次の図に、[言語] タブが開かれている [Word のオプション] ダイアログボックスを示します。

図 2. [Word オプション] ダイアログボックスの言語オプション
[表示言語の選択] で表示する言語 (スペイン語など) を選択して、上向き矢印を選択してスペイン語をリストの最初の位置に移動します。または、編集に使用する言語を変更するには、[ 編集言語の選択] で、編集に使用する言語 (スペイン語など) を選択し、[ 既定値に設定] を選択します。
[OK] をクリックして選択内容を確認し、Word を閉じます。
Visual Studio で F5 キーを押してサンプルアドインを実行するか、メニューバーから [デバッグ>の開始] [デバッグ ] を選択します。
Word で [ホーム]、[作業ウィンドウを表示] の順に選択します。

実行すると、次の図に示すように、アドイン UI の文字列がアプリケーションで使用される言語と一致するように変更されます。

図 3. ローカライズされたテキストが表示されたアドインの UI

ローカライズされた UI テキストを含むアプリ。

Office アドインのローカライズ

ロケール固有文字列を判別するための JavaScript API の使用

マニフェストでのローカライズの制御

例

拡張オーバーライドをローカライズする

日付/時刻の形式のクライアントロケールへの関連付け

Visual Studio を使用してローカライズおよびグローバル化されたアドインを作成する

例: ローカライズされた Office アドインの作成

表示または編集用の追加言語を使用できるように Office を構成する

Office アドインプロジェクトの作成

アドインに使用されるテキストのローカライズ

アドインの表示名と説明をローカライズする

アドイン UI をレイアウトする

ローカライズされた文字列を含むリソースファイルの追加

リソースファイルをアドインプロジェクトに追加する

アドインの UI に使用するテキストのローカライズ

ローカライズされたアドインのテスト

関連項目

フィードバック

その他のリソース

Office アドインのローカライズ

ロケール固有文字列を判別するための JavaScript API の使用

マニフェストでのローカライズの制御

例

拡張オーバーライドをローカライズする

日付/時刻の形式のクライアント ロケールへの関連付け

Visual Studio を使用してローカライズおよびグローバル化されたアドインを作成する

例: ローカライズされた Office アドインの作成

表示または編集用の追加言語を使用できるように Office を構成する

Office アドイン プロジェクトの作成

アドインに使用されるテキストのローカライズ

アドインの表示名と説明をローカライズする

アドイン UI をレイアウトする

ローカライズされた文字列を含むリソース ファイルの追加

リソース ファイルをアドイン プロジェクトに追加する

アドインの UI に使用するテキストのローカライズ

ローカライズされたアドインのテスト

関連項目

フィードバック

その他のリソース

日付/時刻の形式のクライアントロケールへの関連付け

Office アドインプロジェクトの作成

ローカライズされた文字列を含むリソースファイルの追加

リソースファイルをアドインプロジェクトに追加する