評価（レーティング）
評価コンポーネントは、ユーザーがアイコン（一般的には星だが、他のアイコンも使用可能）をいくつか選択することで評価を提供できるようにします。ユーザーフィードバックを収集したり評価データを表現したりする、視覚的に魅力的な方法です。
概要
評価コンポーネントは 入力 コンポーネントで、一連のアイコンを表示し、ユーザーがアイコンをクリックして評価値を選択できるようにします。コンポーネントは読み取り専用モードとインタラクティブモードの両方で使用できます。
主な特長
カスタマイズ可能なアイコン: 評価を表すアイコンを選択します（星が一般的ですが、他にも多くの選択肢があります）。
設定可能なスケール: 最小および最大の評価値を設定します。
読み取り専用/無効モード: ユーザー入力を許可せずに評価を表示します。
インタラクション: ユーザーが評価を変更したときにアクションをトリガーします。
連続選択: 評価コンポーネント上をスライドして、一度に複数のアイコンを選択します。
評価の設定
キャンバス上で評価コンポーネントを選択し、プロパティパネル（右パネル）でそのプロパティにアクセスします。
基本プロパティ
これらのプロパティは、評価コンポーネントの基本的なデータとラベリングを制御します。
API 名： （テキスト） 一意の この特定の評価コンポーネントをあなたのダイナミックコンポーネント内で識別するための識別子。わかりやすい名前を使用してください（例:
ProductRating,CustomerSatisfactionRating）。この名前は、インタラクションや数式でコンポーネントを参照する際に使用されます。ラベル： （テキスト）評価アイコンの上または横に表示されるテキストラベル。例: 「この製品を評価:」「満足度:」「総合評価:」。
フィールドレベルヘルプ: （テキスト、任意）ラベルの横に表示され、追加の文脈や指示を提供するヘルプテキスト。
値： （数値） これは、評価コンポーネントとのインタラクションにおいて最も重要なプロパティです。 これは 現在選択されている評価値 （例: 3、5、1）を保持します。
データバインディング: あなたは バインド このプロパティを 数値 変数リソースにバインドするべきです。これにより、次のことが可能になります:
ユーザーが選択した評価を保存する。
コンポーネントの他の部分（例: フィルター、数式、インタラクション）で評価値を使用する。
「 デフォルト 評価」を、変数リソースを初期化して設定する。
外観プロパティ
これらのプロパティは、評価コンポーネントの視覚的な表示を制御します
アイコン名： （テキスト）評価に使用するアイコン名。Avonni は Salesforce SLDS アイコンを使用します。一般的な例:
utility:star（星評価の場合）utility:like（賛成/反対の親指アイコン）utility:smiley_and_people（スマイリーフェイス）[Salesforce SLDS アイコンのドキュメント]（ここにリンクを挿入）を参照して、利用可能なアイコンの完全な一覧を確認してください。
また、 バインド このプロパティを変数または数式リソースにバインドして、データや条件に基づいてアイコンを動的に変更できます。
バリアント： （テキスト - オプションから選択）次の ラベル:
標準の視覚スタイルと配置を制御します: ラベルは評価アイコンの上に表示されます。label-inline：ラベルは評価アイコンの左側に表示されます。label-stacked：ラベルは評価アイコンの上に表示されます（標準に似ていますが、間隔/スタイルが異なる場合があります）。label-hidden：ラベルは非表示です。評価の目的が文脈や他の UI 要素から明確な場合にのみ使用してください。
最小: （数値）許可される最小の評価値。これは通常
0や1です。デフォルトについては、コンポーネント固有のドキュメントを確認してください。最大: （数値）許可される最大の評価値。これは 表示されるアイコンの総数を決定します。デフォルトは多くの場合
5.値の表示非表示: （ブール値 - チェックボックス）有効にすると、 数値の 評価値は非表示になり、アイコンのみが表示されます。無効にすると、（コンポーネントのスタイルにより）数値がアイコンの横に表示される場合があります。
動作プロパティ
これらのプロパティは、ユーザーが評価コンポーネントとどのようにやり取りするか、ならびに全体的な動作を制御します
選択方法: （テキスト - オプションから選択）ユーザーがどのように評価を選択できるかを制御します:
continuous：ユーザーはコンポーネント上をスライドして値を選択できます。single：ユーザーは一度に 1 つの値を選択できます。
必須: （ブール値 - チェックボックス）有効にすると、ユーザーは 必ず 他のアクション（例: フォームの送信）を実行する前に評価を選択する必要があります。通常、これを検証ロジックと組み合わせて使用します。
読み取り専用: （ブール値 - チェックボックス）有効にすると、ユーザーは 閲覧 はできますが、 変更できません 。既存の評価を表示するのに役立ちます。
無効: （ブール値 - チェックボックス）有効にすると、評価コンポーネントは完全に無効になり、操作できません。これは、評価が該当しない、または変更できないことを視覚的に示します。
表示： （ブール値）評価コンポーネントがページ上で可視かどうかを制御します。動的な可視性のために、ブール変数や数式にバインドできます
インタラクション
評価コンポーネントは On Change インタラクションをサポートします。ユーザーが評価の選択を変更するたびにこのインタラクションがトリガーされます。
On Change： このインタラクションを使用して次のことを行います：
変数値の設定: 新しい評価値（
@RatingComponent.valueから）で変数リソースを更新します。これは 最も一般的な方法です ユースケース。フローを実行： フローを起動し、新しい評価を入力変数として渡します。
データを更新（Refresh Data）： 新しい評価に基づいてページ上の他のコンポーネントを更新します。
トーストを表示： 確認メッセージを表示します。
「変更時」インタラクション内で、次を使用して現在選択されている評価値にアクセスできます:
@RatingComponent.value
（ RatingComponent を 実際の （あなたの評価コンポーネントの）です。これは 数値.
：最大値。
例 1: 基本的な評価入力
評価コンポーネントを追加します。
データに応じて
次のように設定しますを「この製品を評価:」に設定します。データに応じて
アイコン名最小（Min）utility:star.データに応じて
を最小（Min）5.という名前の数値変数リソースを作成します
productRating.評価コンポーネントの
Valueレンジスライダーの{!productRating}.
これにより基本的な 5 段階の星評価入力が作成されます。ユーザーの選択は productRating 変数に代入します。
例 2: 平均評価の読み取り専用表示
評価コンポーネントを追加します。
データに応じて
次のように設定しますを「平均評価:」に設定します。データに応じて
アイコン名最小（Min）utility:star.データに応じて
を最小（Min）5.データに応じて
読み取り専用を true に設定します。という名前の変数または数式を作成します
averageRating.評価コンポーネントの
Valueレンジスライダーの{!averageRating}.短い情報を表示するために
レコードを取得読み込み時インタラクションで Salesforce から値を取得します。
これにより、 表示します 平均評価を表示します（ averageRating 変数に計算して保存する方法があることを前提）、ただしユーザーは変更できません。
例 3: 変更時インタラクション
例 1 の手順に従って評価を作成します。
評価コンポーネントを選択します。
インタラクションに移動し、
On Changeおよび
Show Toastあなたの評価コンポーネントの値を使用してユーザーの評価を確認するアクションを選択します。変数が更新され、それらの値を使用してデータテーブルをフィルタリングできます。
データバインディング:
Valueプロパティが重要です。ユーザーの選択を保存するために数値変数にバインドします。読み取り専用と無効の違い: 違いを理解してください。
読み取り専用は変更を防ぎつつコンポーネントを表示します。無効はコンポーネントをグレーアウトし、すべての操作を防ぎます。インタラクション: 「変更時」インタラクションを使用して、評価コンポーネントを動的で反応の良いものにします。
アクセシビリティ: 明確な
次のように設定します.バリアント：ラベルの表示を適応させます。
まとめ: 評価コンポーネントは、視覚的で直感的なアイコンベースのインターフェイスを使ってユーザーから評価を収集・表示する簡単な方法です。
最終更新
役に立ちましたか？