ローカライズ API コンポーネントの実装

このサンプルはコード コンポーネントのローカライズ方法を紹介します。 このサンプルでは、増分コンポーネント を使用して、ユーザーが選択した言語に基づいて増分ボタンに表示されるテキストをローカライズします。

注意

コード コンポーネントのランタイム ローカライズは、カスタム ページおよびキャンバス アプリケーションのパブリック プレビューにあります。 詳細情報: ブログ: カスタム ページとキャンバス アプリでのコード コンポーネントのランタイム ローカライズ サポート。

Power Apps component framework は、ローカライズされた文字列の管理に使用される文字列 (resx) Web リソースを実装する概念を使用し、任意のユーザー インターフェイスに表示されます。 詳細情報については、RESX Web リソース を参照してください。

使用可能な対象

モデル駆動型アプリとキャンバス アプリ

コード

完全なサンプル コンポーネントは、こちら からダウンロードできます。

既存のプロジェクトをローカライズするためにやるべきことは、Web リソースの文字列に記載されているようにそれぞれ特定の言語にひとつずつ追加のリソース (resx) ファイルを作成し、リソース ノードの下にあるコントロールのマニフェスト ファイルの一部としてそれらを含めます。

Power Apps component framework はユーザーの言語を識別し、context.resources.getString メソッドを使用して文字列にアクセスするとその言語固有のリソース ファイルから文字列を返します。

このサンプルでは、言語コード 3082 と 1035 を持つふたつの言語 Spanish と Finnish がそれぞれ定義されます。 Increment component サンプルのコピーを作成し、その名前を Localization API に変更しました。 サブフォルダ内のファイルを含むすべての対応するファイルは、それに応じて名前が変更されます。

TS_LocalizationAPI 下の文字列フォルダに、スペイン語とフィンランド語に対応する接尾辞が 3082 と 1035 のふたつ追加の resx ファイルが追加されます。 作成された新しいファイルはファイル名の末尾が {filename}.3082.resx と {filename}.1035.resx になる必要があり、これはフレームワークが命名規則に基づきユーザー文字列の読み取りにどのリソース ファイルを選択するか識別するためです。

これらすべてのリソースファイルの文字列に使用されるキーが、すべての言語で同じ名前を共有していることを確認してください。 さて、コンポーネントが UI に表示されるとき、コードでは context.resources.getString("PCF_LocalizationSample_ButtonLabel") を使用してボタンに表示する値を取得します。

このコード行が実行されると Power Apps component frameworkが自動的にユーザーの言語を識別して、定義した対応する言語ファイルで提供されるキーを使用してボタン ラベルの値を取得します。 以下は、このサンプル コンポーネントでサポートされる 3 つの言語で表示されるテキストです。

LanguageCode	表示される値
3082	増分
1041	増分
1035	lisäys

関連トピック

サンプル コンポーネントをダウンロード
サンプルコンポーネントの使用方法
Power Apps Component Framework API の参照
Power Apps component framework のマニフェスト スキーマ リファレンス

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。