> 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-timeline.md).

# AX - タイムライン

## 概要

**AX - タイムライン** Experience Siteページ上でSalesforceレコードを時系列順に表示するExperience Cloudコンポーネントです。

ケース履歴、注文のタイムライン、プロジェクトのマイルストーン、または日付付きレコードなど、ポータルユーザーの日時ベースのアクティビティを表示するために使用します。ユーザーはエントリを検索・フィルターしたり、アイテムからレコードを開いたり（ **クリック時** アイテムへのインタラクションで）、期間ごとに整理されたイベントを表示できます。日付フィールドを持つ標準オブジェクトまたはカスタムオブジェクトからデータを取得します。

スクロール可能な時系列形式で、「いつ何が起きたか」をポータルユーザーが確認する必要があるアクティビティフィード、ケース履歴、注文追跡タイムライン、プロジェクトのステータス更新などに最適です。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FfhHIof5HQHt9iGpbKEHS%2Fax-timeline-vertical.png?alt=media" alt=""><figcaption><p>月ごとにグループ化された縦型タイムラインで、新しいものが最初に表示されます。最新の2件はフィールドが展開され、2列で表示されます。</p></figcaption></figure>

{% hint style="success" %}
Avonni Timeline は [リアクティブ対応](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/hajimeni/reactive-components.md)
{% endhint %}

{% hint style="info" %}
**実際のプロジェクトで見る**

[インストールを追跡](https://docs.avonnicomponents.com/projects/use-cases/portals-and-partner-sites/track-my-installation)：月ごとにグループ化された、顧客ポータルのインストール追跡ツールです。
{% endhint %}

## 設定

### 項目

この **項目** プロパティにタイムラインのエントリを保持します。取得元を選択してください：

| 名前      | 説明                                      |
| ------- | --------------------------------------- |
| **手動**  | タイムライン項目とその詳細を手動で入力します。                 |
| **クエリ** | クエリを使用してSalesforceレコードでタイムラインを自動的に埋めます。 |

各項目は同じ設定から作成されます。 **手動** モードでは項目ごとに入力し、 **クエリ** モードでは、クエリしたオブジェクトの各フィールドにマッピングします。

| 設定                | 機能                                                              |
| ----------------- | --------------------------------------------------------------- |
| **タイトル**          | 項目の見出しです。                                                       |
| **説明**            | タイトルの下のテキストです。                                                  |
| **アバター**          | 項目のアイコン： **イニシャル**, **アイコン名**, **画像**、および **プレゼンスタイプ**.         |
| **日付**            | 必須です。項目をタイムライン上に配置します。クエリモードではクエリの並び順も決定します。 **並び順**.           |
| **アクティブ**         | 項目を現在のものとしてマークします。                                              |
| **チェックボックスあり**    | 項目にチェックボックスを追加します。                                              |
| **フィールド**         | ユーザーが項目を開いたときに表示されるラベルと値のペアです。 **フィールド属性** それらのレイアウトを設定します。     |
| **名前** / **キー項目** | 項目の一意の識別子（手動： **名前**、クエリ： **キー項目**, `{{Record.Id}}` をデフォルトで使用）。 |
| **フィルター**         | クエリモードのみ。ユーザーがフィルターできるフィールド。参照 **フィルターメニュー属性**.                 |
| **検索フィールド**       | クエリモードのみ。検索ボックスが検索対象とするフィールド。 **検索可能**.                         |
| **クリック時**         | レコードへの移動など、ユーザーが項目をクリックしたときの動作です。これがないと項目はクリックできません。            |

### 基本設定

**タイトル** はタイムラインの主見出しで、 **キャプション** その下に表示される簡単な説明または補足テキストです。 **タイトルテキストのスタイル** と **キャプションテキストのスタイル** それぞれのタイポグラフィを設定します： `見出し1` から `見出し4`、または `段落1` / `段落2`.

### 視覚的・機能的要素

| 設定              | 機能                                                                                                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **API名**        | コンポーネントを参照するために使う一意の識別子。                                                                                                                                           |
| **アイコン名**       | タイムラインのタイトルの横に表示されるSalesforce Lightning Design Systemのアイコンです。各項目の独自アイコンは、項目の **アバター**.                                                                             |
| **アイコンサイズ**     | そのヘッダーアイコンのサイズ： `XXS`, `XS`, `小`, `中` （デフォルト）または `大`.                                                                                                              |
| **項目アイコンサイズ**   | 各項目アイコンのサイズ： `XXS`, `XS`, `小` （デフォルト）、 `中` または `大`.                                                                                                                |
| **方向**          | `縦` （デフォルト）または `横` レイアウト。                                                                                                                                          |
| **並び順**         | `昇順` または `降順` （デフォルト）の時系列順。                                                                                                                                        |
| **グループ化基準**     | 項目を `日`, `週`, `月`、または `年`でグループ化します。未設定にすると、項目をグループ化せずに一覧表示します。本日以降の日付の項目は **今後**.                                                                                  |
| **項目の日付形式**     | 項目上での日付表示方法： **標準**, **相対** （例：「2日前」）、 **プリセット** （Luxonのプリセット、 `DATE_MED` がデフォルト）または **カスタム** （デフォルトの `LLLL dd, yyyy, t`。これは「September 02, 2026, 1:00 PM」と表示されます）。 |
| **結合済み**        | ヘッダーをタイムライン本体に隙間なく接続します。下部ボーダーのスタイルは **ヘッダーボーダー**で設定します。デフォルトではオフです。                                                                                               |
| **折りたたみ可能**     | 各グループを折りたたみ可能にします。必要です **グループ化基準**で設定します。デフォルトではオフです。                                                                                                              |
| **閉じた状態**       | これらのグループを折りたたんだ状態で開始します。必要です **折りたたみ可能**で設定します。デフォルトではオフです。                                                                                                        |
| **検索可能**        | 検索ボックスを追加します。手動モードでは項目のタイトルと説明を検索し、クエリモードでは **検索フィールド** 「Items」マッピング内のフィールドを検索します。デフォルトではオフです。                                                                     |
| **ページネーションを表示** | 項目をページに分割し、 **最大表示項目数** を1ページあたりの表示件数にします（空の場合は20）。                                                                                                                |
| **最大表示項目数**     | がオンで、 **ページネーションを表示** ページサイズとして扱います。オフの場合、縦型タイムラインではその件数の項目を表示し、その後に **さらに表示** ボタンを表示します。                                                                          |
| **クリック時にハイライト** | 項目をクリックすると視覚的にハイライトします。                                                                                                                                            |

{% hint style="info" %}
グループ化、折りたたみ可能なグループ、項目アクション、項目アイコンサイズ、クリック時のハイライト、および **さらに表示** ボタンは縦向きにのみ適用されます。
{% endhint %}

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FZjX4OXJi4jlVjQQnie8o%2Fax-timeline-horizontal.png?alt=media" alt=""><figcaption><p>OrientationをHorizontalに設定した同じ項目です。上部の帯には15日間の範囲が表示され、下の帯にはすべての項目が並び、ユーザーはハイライトされた範囲をドラッグして移動します。</p></figcaption></figure>

### インタラクティブ性とカスタマイズ

**ヘッダーアクション** タイムラインのヘッダーにアクションボタンを追加します。各アクションには **ラベル**、 **名前**、 **アイコン名**、 **タイトル**, **代替テキスト** および **クリック時** インタラクションがあります。 **表示するアクションボタン数** ヘッダーアクションのうち、何件をボタンとして表示し、残りをメニューに回すかを設定します。

**項目アクション** 項目レベルでアクションボタンを追加します（縦向きのみ）。

**フィールド属性** 各項目のレイアウトを設定します **フィールド**:

* **列数**：デフォルトは1です。480px未満のコンテナ、およびサイズ別の値が設定されていない場合に適用されます。
* **小**, **中** と **大サイズコンテナの列数**：各コンテナサイズごとの列数。
* **バリアント**: `標準` （デフォルト）、 `ラベル非表示`, `ラベルを横並び` または `ラベルを縦積み`.

**フィルターメニュー属性** フィルターの表示方法を設定します。フィルターはクエリモードのみで利用できます。まず **フィルター** Itemsマッピングのフィールドを選択してください。 **タイプ** それらを `横` （デフォルト）、 `ポップオーバー`、または `パネル`に配置し、 **ピックリストフィルターの並び順**, **レコードのピックリスト値を使用** と **連動フィルター値を使用** ピックリストの選択肢の表示順を制御します。

各フィルターには演算子もあり、フィルター上部のメニューから選択します。テキスト、ピックリスト、複数選択ピックリスト、ルックアップの各フィルターでは `等しい` （デフォルト）、 `等しくない`, `空` と `空でない`。数値、日付、時刻フィルターでは `〜の間` （デフォルト）、 `〜の間ではない`, `等しい`, `等しくない`, `より小さい`, `以下`, `より大きい`, `以上`, `空` と `空でない`. `空` と `空でない` は値を取らないため、どちらかを選択するとフィルターの入力欄は非表示になります。チェックボックスフィルターには演算子メニューはありません。

**検索エンジン属性** 検索ボックスをカスタマイズします：その **プレースホルダー** (`検索` （デフォルト）、およびその **位置**, `左` （デフォルト）、 `右`, `中央` または `幅いっぱい`.

**ページネーション属性** のラベルとアイコンを設定します **最初**, **前へ**, **次へ** と **最後** ボタン、および配置： `左` （デフォルト）、 `中央` または `右`.

**結果なしメッセージ** 検索またはフィルターに一致する項目がない場合、あるいはデータソースが何も返さない場合に、デフォルトの空状態を独自のテキストに置き換えます。 **結果なしメッセージ属性** その空状態に何を表示するかを制御します： **結果なし画像を非表示** イラストを削除し、 **結果なしメッセージを非表示** テキストを削除します。どちらもデフォルトではオフです。

## スタイル

タイムラインの外観は **スタイル** プロパティエディターのセクションからカスタマイズできます。

{% tabs %}
{% tab title="マージン" %}
タイムライン周囲の外側余白を制御します。
{% endtab %}

{% tab title="パディング" %}
タイムライン内部の余白を制御します。
{% endtab %}

{% tab title="サイズ" %}
タイムラインの寸法（幅 / 高さ / オーバーフロー）を制御します。
{% endtab %}

{% tab title="ボーダー" %}
タイムライン周囲のボーダー（色 / 太さ / スタイル / 角丸）を制御します。
{% endtab %}

{% tab title="ヘッダー" %}

| 名前                 | 説明                |
| ------------------ | ----------------- |
| **背景色**            | ヘッダーの背景色を設定します。   |
| **パディング（上、右、下、左）** | ヘッダー内の内側余白を設定します。 |
| **下マージン**          | ヘッダー下のスペースを決定します。 |
| {% endtab %}       |                   |

{% tab title="ヘッダーボーダー" %}

| 名前                 | 説明                                     |
| ------------------ | -------------------------------------- |
| **ボーダー色**          | ヘッダーのボーダー色を決定します。                      |
| **ボーダーサイズ**        | ヘッダー周囲のボーダーの太さを調整します。                  |
| **ボーダースタイル**       | ボーダーのスタイルを選択します（例：実線、破線、点線）。           |
| **ボーダー半径**         | ヘッダーの角を丸くして、やわらかな見た目にします。              |
| **下ボーダー色（結合時）**    | 「 **結合済み** 」がオンのとき、ヘッダー下部ボーダーの色を設定します。 |
| **下ボーダーサイズ（結合時）**  | その下部ボーダーの太さを調整します。 **結合済み** がオンのとき。    |
| **下ボーダースタイル（結合時）** | その下部ボーダーのスタイルを選択します。 **結合済み** がオンのとき。  |
| {% endtab %}       |                                        |

{% tab title="ヘッダータイトル" %}

| 名前           | 説明                            |
| ------------ | ----------------------------- |
| **色**        | タイトルテキストの色を変更します。             |
| **フォントサイズ**  | タイトルテキストのサイズを調整します。           |
| **フォントウェイト** | タイトルテキストの太さを変更します。            |
| **フォントスタイル** | タイトルテキストにスタイル（例：斜体、標準）を適用します。 |
| {% endtab %} |                               |

{% tab title="ヘッダーキャプション" %}

| 名前           | 説明                    |
| ------------ | --------------------- |
| **色**        | キャプションテキストの色を設定します。   |
| **フォントサイズ**  | キャプションテキストのサイズを調整します。 |
| **フォントウェイト** | キャプションテキストの太さを変更します。  |
| **フォントスタイル** | キャプションテキストにスタイルを適用します |
| {% endtab %} |                       |

{% tab title="ヘッダーアバター" %}

| 名前           | 説明                                |
| ------------ | --------------------------------- |
| **背景色**      | ヘッダーアバターの背景色を設定します。               |
| **前景色**      | アバター内コンテンツ（アイコンまたはイニシャル）の色を設定します。 |
| **ボーダー半径**   | アバターの角を丸くして、やわらかな見た目にします。         |
| {% endtab %} |                                   |

{% tab title="項目" %}

| 名前           | 説明                         |
| ------------ | -------------------------- |
| **行数制限**     | 項目の説明を指定行数に制限し、それ以上は省略します。 |
| **アイコン背景色**  | 各項目のアイコンの背景色を設定します。        |
| {% endtab %} |                            |

{% tab title="項目本文" %}

| 名前             | 説明                                  |
| -------------- | ----------------------------------- |
| **ホバー時の背景色**   | ポインターが重なっている間の項目の背景色。               |
| **ハイライト時の背景色** | によってハイライトされた項目の背景色 **クリック時にハイライト**. |
| {% endtab %}   |                                     |

{% tab title="項目フィールド" %}

| 名前           | 説明                    |
| ------------ | --------------------- |
| **インライン間隔**  | 項目内のフィールド間の水平スペース。    |
| **ブロック間隔**   | 項目内のフィールド間の垂直スペース。    |
| **背景色**      | 項目のフィールド領域の背景色を設定します。 |
| **ボーダー色**    | フィールド領域のボーダー色を決定します。  |
| **ボーダーサイズ**  | そのボーダーの太さを調整します。      |
| **ボーダースタイル** | そのボーダーのスタイルを選択します。    |
| **ボーダー半径**   | フィールド領域の角を丸くします。      |
| {% endtab %} |                       |

{% tab title="ページネーションボタン" %}

| 名前                 | 説明                                                             |
| ------------------ | -------------------------------------------------------------- |
| **背景色**            | ボタンの背景色を変更します。Active、Hover、Disabled それぞれに個別の値があります。            |
| **テキスト/アイコンの色**    | ボタン内のテキストまたはアイコンの色を調整します。Active、Hover、Disabled それぞれに個別の値があります。 |
| **ボーダー色**          | ボタンのボーダー色を設定します。Active、Hover、Disabled それぞれに個別の値があります。          |
| **ボーダーサイズ / スタイル** | ページネーションボタンのボーダー設定を行います。                                       |
| **アクティブなボタン…**     | 現在表示中のページのボタンに、同じ背景色、テキスト/アイコン色、ボーダー色を適用します。                   |
| {% endtab %}       |                                                                |

{% tab title="フッター" %}

| 名前           | 説明                  |
| ------------ | ------------------- |
| **背景色**      | フッターの背景色を設定します。     |
| **ボーダー色**    | フッターの枠線の色を決定します。    |
| **ボーダーサイズ**  | フッターの枠線の太さを調整します。   |
| **ボーダースタイル** | フッターの枠線のスタイルを選択します。 |
| **ボーダー半径**   | フッターの角を丸くします。       |
| {% endtab %} |                     |

{% tab title="もっと見るボタン" %}

| 名前                    | 説明                                 |
| --------------------- | ---------------------------------- |
| **ブロック開始 / ブロック終了**   | ボタンの上下の余白です。                       |
| **インライン開始 / インライン終了** | ボタンの前後の横方向の余白です。                   |
| **背景色**               | ボタンの背景色。アクティブ時とホバー時の値は別々に設定できます。   |
| **テキスト色**             | ボタンのテキスト色。アクティブ時とホバー時の値は別々に設定できます。 |
| **ボーダー色**             | ボタンの枠線の色。アクティブ時とホバー時の値は別々に設定できます。  |
| **枠線サイズ / 枠線の角丸**     | ボタンの枠線の太さと角の丸み。                    |
| {% endtab %}          |                                    |

{% tab title="Flow ダイアログ & パネル" %}
によって開かれるダイアログまたはサイドパネルのスタイルを設定します **Flow ダイアログを開く** または **Flow パネルを開く** インタラクションがあります。

| 名前                  | 説明                                               |
| ------------------- | ------------------------------------------------ |
| **Flow ダイアログ ヘッダー** | 背景、下部の枠線（色とサイズ）、ラベルのタイポグラフィ（色、フォントサイズ、フォントウェイト）。 |
| **Flow ダイアログ フッター** | 背景と上部の枠線（色とサイズ）。                                 |
| **Flow パネル**        | パネル自体の背景色と枠線（色、サイズ、スタイル、角丸）。                     |
| **Flow パネル ヘッダー**   | 背景、下部の枠線、ラベルのタイポグラフィ、および閉じるアイコンの色。               |
| {% 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-timeline.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.
