> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-avatar-group.md).

# AX - アバターグループ

## 概要

**AX - アバターグループ** Experience Sites ページ上で、複数のプロフィール画像、イニシャル、またはアイコンをコンパクトな横並びで表示する Experience Cloud コンポーネントです。

チームメンバー、プロジェクトの貢献者、取引先責任者、または関連するユーザーやレコードのグループを表示するために使用します。このコンポーネントはアバターを水平方向に並べ、表示領域に収まりきらない場合は「+X」インジケーターを表示します。

チーム名簿、コラボレーショングループ、ケース割り当ての表示、またはカスタマーポータルやパートナーポータルで共有レコードへのアクセス権を持つユーザーを表示するのに最適です。

## 設定

### データソース

アバターグループに適切な人を表示させるために、情報の取得先を指定します。ここで **データソース** の出番です。アバターを Salesforce データの中心につなぐものだと考えてください。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-6a64f5314735e74363472f91359b1b28f207b8c7%2F2024-07-03_07-00-12.png?alt=media" alt=""><figcaption></figcaption></figure>

#### **手動**

このオプションは、少人数のチームや、特定のイベントやプロジェクトに対してのみアバターを表示したい場合に最適です。

1. **各 व्यक्तिを追加:** 含めたい各個人について、アバターグループの設定に直接詳細を入力します。
2. **重要情報を入力:** これには次が含まれます:
   * **アバター画像:** 写真がある場合は、ここにアップロードできます。
   * **イニシャル:** 画像がない場合は、これが表示されます。
   * **その他の詳細:** その人の役職や部署など、追加情報を含めることができます。

手動オプションは手間がかかりますが、アバターグループに誰を表示するかを完全に制御できます。

#### **クエリ**

チームの変更が頻繁な場合や、アバターを常に Salesforce 組織内の最新情報に合わせたい場合は、このオプションが最適です。

仕組みは次のとおりです:

1. **オブジェクトを選択:** アバター情報が保存されている Salesforce オブジェクト（User、Contact、またはカスタムオブジェクトなど）を選択します。
2. **データをマッピング:** アバターグループの属性（名前、役職、プロフィール画像など）と、選択したオブジェクト内の対応するフィールドを結び付けます。これにより、アバターグループは各人の正しい詳細がどこにあるかを正確に把握できます。

クエリオプションを使用すると、アバターグループは Salesforce データを動的に反映し、常に最も正確で最新の情報を表示します。

### バリアント

* **四角:** アバターは四角形で表示され、クラシックで洗練された見た目です。これが既定値です。
* **円形:** アバターは、より現代的で親しみやすい円形で表示されます。
* **空:** アバターは角丸の四角形で表示されます。これは **正方形** — ただし **円形** 形が変わるだけです。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-738ae02abb3eacaee416f1f4ac4770274757a462%2F2024-07-03_06-58-10.png?alt=media" alt=""><figcaption></figcaption></figure>

### サイズ

* 各アバターのサイズを制御します: **極小**, **小**, **中** （デフォルト）、 **大**, **特大** または **超特大**.

### レイアウト

* **スタック:** 既定値です。アバターは 1 行に並び、互いに重なって表示されるため、グループは非常に小さい幅で収まります。
* **グリッド:** アバターは重ならずに横に並び、必要に応じて次の行に折り返されるため、より大きなグループに適しています。
* **リスト:** 1 行に 1 つのアバターを縦に積み重ねて表示します。狭い領域やサイドバーで便利で、さらに多くのアバターを読み込むためにスクロールする唯一のレイアウトです。

### 最大件数

* グループに表示するアバターの数を制限します。これにより、レイアウトをすっきり保ち、視覚要素が多すぎてユーザーを圧倒するのを防げます。

### イニシャルの自動書式設定

* これをオンにすると、各アバターに表示されるイニシャルが自動的に書式設定されます。値が複数語で構成されている場合は各語の先頭文字を使用し、1 語の場合は先頭 2 文字を使用します。既定ではオフです。

### アイコン位置

* **アイコン位置** 各アバターの内側にアイコンを配置します — **先頭**, **中央** （既定）または **末尾**.

### 検索結果なしメッセージ

* **検索結果なしメッセージ** データソースがアイテムを返さない場合、既定の空状態を独自のテキストに置き換えます。 **検索結果なしメッセージ属性** その後、空状態に表示する内容を制御します: **検索結果なし画像を非表示** イラストを非表示にし、 **検索結果なしメッセージを非表示** でテキストを非表示にします。どちらもデフォルトではオフです。

## インタラクション

### リンク先（アバターをインタラクティブにする）

このセクションは、アバターに超能力を与えるものだと考えてください。クリックするとユーザーを新しい場所へ移動できます。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-5a9b69223bea8e9a73a175eee3b81773949c53af%2F2024-07-03_06-53-05.png?alt=media" alt=""><figcaption></figcaption></figure>

#### これが役立つのはなぜですか?

* **ユーザープロフィール:** 専門家チームを表示する場面を想像してください。アクションへのリンクを設定しておけば、アバターをクリックするとその人のフルプロフィールページを開くことができます。
* **カスタムアクション:** クリック時に特定のフローを起動したり、外部 वेबसाइटへリダイレクトしたりしたい場合もあるでしょう。

#### 仕組み

1. **タイプを選択:** クリックでユーザーをどこに移動させるかを選択します。レコードページ、カスタムページ、フロー、または外部 URL にできます。
2. **アクション名をカスタマイズ:** ナビゲーション操作を使用する場合、呼び出すアクション名を選択します。

リンク先機能を使用すると、アバターグループは単なる顔の表示以上のものになります。追加情報やアクションへの入口になるのです。

## ユースケース

これらの設定オプションを使うことで、Avonni Avatar Group コンポーネントをニーズに合わせて調整できます。たとえば、プロジェクトページでチームメンバーを紹介したり、取引先ページで顧客のアバターを表示したり、コミュニティメンバーの見た目に魅力的な一覧を作成したりできます。

Avonni Avatar Group コンポーネントは非常に柔軟です。スタイルをさらに調整して見た目をカスタマイズしたり、インタラクティブ要素を追加してアバターをクリック可能にしたり、ユーザープロフィールへリンクしたりできます。

Avonni Avatar Group コンポーネントを活用することで、Experience Cloud サイトのユーザーに、よりパーソナライズされ、情報量の多い体験を提供できます。つながりを育み、オンラインコミュニティの中にある人間的な要素を際立たせましょう。

## スタイリング

グループの外観を **スタイル** プロパティエディターのセクションからカスタマイズします。

{% tabs %}
{% tab title="マージン" %}
グループの外側余白を制御します（上 / 右 / 下 / 左）。
{% endtab %}

{% tab title="パディング" %}
グループの内側余白を制御します（上 / 右 / 下 / 左）。
{% endtab %}

{% tab title="サイズ" %}
グループ全体の寸法を制御します。
{% endtab %}

{% tab title="ボーダー" %}
グループの周囲の境界線を制御します（色 / サイズ / スタイル / 角丸）。
{% endtab %}

{% tab title="スタックの境界線" %}
積み重なったアバター間の境界線をスタイル設定します。

* **色 / サイズ / スタイル:** スタック境界線の外観を制御します。
  {% endtab %}

{% tab title="さらに表示ボタン" %}
「+X」のもっと見るボタンをスタイル設定します。

* **背景 / テキスト / 境界線の色:** 既定、アクティブ、ホバー時の色を設定します。
* **境界線サイズ / 境界線の角丸:** ボタンの境界線を制御します。
* **ブロック先頭 / ブロック末尾 / インライン先頭 / インライン末尾:** ボタンの周囲の余白を設定します。
  {% endtab %}
  {% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-avatar-group.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
