Pager（キャラクターディスプレイ）

Pagerは、一連のコンポーネントを一度に1つずつ表示します。通常、Pagerは、スライドショーのような時系列で並べられたデータ項目を表示するために使用します。

Pagerの例
キャラクターディスプレイでのPagerのナビゲーション
プロパティ

{
  "type": "Pager",
  "items": [
    {
      "type": "Text",
      "text": "ページ#1に表示されるテキストコンテンツ"
    },
    {
      "type": "Text",
      "text": "ページ#2に表示されるテキストコンテンツ"
    }
  ]
}

キャラクターディスプレイではタッチ入力がサポートされないため、スワイプによるPagerのナビゲーションはできません。ページ間の移動には、AutoPageコマンドやSetPageコマンドを使用してください。

プロパティ

Pagerには、標準のコンポーネントプロパティに加えて次のプロパティがあります。

プロパティ	型	デフォルト	動的	説明
data	データ	<none>	×	このコンテナーにバインドするデータです。
firstItem	コンポーネントとレイアウトの配列	<none>	×	ほかのすべての項目の前に含めるコンポーネントです。
initialPage	整数	0	×	開始ページのインデックスです。
item/items	コンポーネントとレイアウトの配列	[]	×	データセットのインフレートに使用するコンポーネントです。
lastItem	コンポーネントとレイアウトの配列	<none>	×	ほかのすべての項目の後に含めるコンポーネントです。
onPageChanged	コマンドの配列	[]	×	ページが変更されたときに実行するコマンドです。

Pagerは、一連のページとしてユーザーに表示されます。

Pagerのheightは、指定がない場合のデフォルトは1文字になります。Pagerのwidthは、指定がない場合のデフォルトは100%になります。

firstItem

割り当てられている場合、1つの子のみのインフレート方法を使用して、Pagerの先頭に単一のコンポーネント／レイアウトが追加されます。

item（items）

Pagerに表示するコンポーネントとレイアウトの配列です。dataプロパティが割り当てられている場合、Pagerはデータ配列のインフレート方法を使用します。dataプロパティが割り当てられていない場合、Pagerは子コンポーネントの単純な配列のインフレート方法を使用します。

lastItem

割り当てられている場合、1つの子のみのインフレート方法を使用して、Pagerの末尾に単一のコンポーネント／レイアウトが追加されます。

initialPage

表示する最初のページのインデックスです。インデックスは0から始まり、デフォルトは0です。firstItemが指定されている場合は、そのインデックスが0になります。

onPageChanged

onPageChangedハンドラーは、ページが新しいページに完全に切り替わったときに実行されます。生成されるイベントの形式は次のようになります。

"event": {
  "source": {
    "source": "Pager",
    "handler": "Page",
    "id": ID,          // PagerのID
    "uid": UID,        // ランタイムで生成されたコンポーネントの一意のID
    "value": NUMBER    // 新しいページのインデックス
  }
}

event.source.valueは、新しいページのインデックス（0から始まるインデックス）に設定されます。

このページは役に立ちましたか？

フィードバックを送信

最終更新日: 2025 年 12 月 17 日