カスタム表示ラベル
カスタム表示ラベルを使用することで、開発者は、情報 (ヘルプテキストやエラーメッセージなど) を自動的にユーザーの母国語に表示する多言語アプリケーションを作成できます。カスタム表示ラベルは、Apex クラス、Visualforce ページ、Lightning ページ、または Lightning コンポーネントからアクセスできるカスタムテキスト値です。テキスト値は、Salesforce でサポートされるすべての言語に翻訳することができます。
必要なエディション
| 使用可能なインターフェース: Salesforce Classic および Lightning Experience の両方 |
| 使用可能なエディション: Developer Edition、Professional Edition、Enterprise Edition、Performance Edition、および Unlimited Edition |
| 必要なユーザー権限 | |
|---|---|
| カスタム表示ラベルを作成、編集、または削除する | 「アプリケーションのカスタマイズ」 |
| 翻訳を作成または上書きする | 「翻訳の管理」 または 「設定・定義を参照する」、および翻訳者として指定されていること |
組織では、最大 5,000 個のカスタム表示ラベルを作成でき、長さは最大 1,000 文字です。管理パッケージのカスタム表示ラベルは、この制限に含まれません。
カスタム表示ラベルにアクセスするには、[設定] から、[クイック検索] ボックスに「カスタム表示ラベル」と入力し、[カスタム表示ラベル] を選択します。
アプリケーションにカスタム表示ラベルを追加する手順は、ユーザーインターフェースによって異なります。次の構文についての詳細は、対応する開発者ガイドを参照してください。
- Apex では、
System.Label.Label_name構文を使用します。System.Labelクラスでメソッドを使用して、翻訳された表示ラベルを確認および取得することもできます。名前空間内の表示ラベルと言語の翻訳が存在するかどうかを確認するには、translationExists(namespace, label, language)を使用します。デフォルト言語設定または言語と名前空間の表示ラベルを取得するには、get(namespace, label, language)を使用します。 - Flow Builder では、
$Labelグローバル変数を使用します。 - Visualforce では、
$Labelグローバル変数を使用します。 - Aura コンポーネントでは、デフォルトの名前空間の
$Label.c.labelName構文を使用するか、組織に名前空間がある場合または管理パッケージの表示ラベルにアクセスするには$Label.namespace.labelNameを使用します。 - Lightning Web コンポーネントで、
@salesforce/label/namespace.Label_name構文を使用して表示ラベルをインポートします。 - Lightning アプリケーションビルダーのコンポーネントラベルと属性では、
{!$Label.customLabelName}式を使用します。
アプリケーションを AppExchange にパッケージするときに、表示ラベルをアプリケーションに組み込みます。
- カスタム表示ラベルの作成および編集
Apex クラス、Visualforce ページ、Lightning ページ、または Lightning コンポーネントから参照できるカスタム表示ラベルを作成して、アプリケーションを多言語にします。 - カスタム表示ラベルの翻訳
ユーザーのデフォルト言語が翻訳言語である場合、カスタム表示ラベルの翻訳が表示ラベルの値のテキストになります。
この記事で問題は解決されましたか?
ご意見をお待ちしております。
