3.0 KiB
3.0 KiB
Cols
コントロール機能：ページネーション付きのスクロール可能な複数列データリストを表示するためのもので、前後ページのデータを動的に読み込むことをサポートしています。コンテンツウォールやカードレイアウトなどのシナリオでよく使用されます。
タイプ：コンテナーコントロール
親クラスコントロール：bricks.VBox
初期化パラメータ
| パラメータ名 | 型 | 説明 |
|---|---|---|
data_url |
文字列 (String) | データ取得用のURLアドレス。非同期でデータを読み込むために使用します。 |
data_params |
オブジェクト (Object) | データリクエスト時に送信される初期パラメータオブジェクト。 |
data_method |
文字列 (String) | リクエストメソッド（例：GET、POST）。デフォルトはGET。 |
page_rows |
数値 (Number) | 1ページあたりにリクエストするデータ行数。 |
cache_limit |
数値 (Number) | キャッシュするページ数の上限。メモリ内に保持する履歴データページ数を制御するために使用します。 |
col_cwidth |
数値 (Number) | 各列の固定幅（ピクセル単位）。動的カラムレイアウト計算に使用されます。 |
mobile_cols |
数値 (Number) | モバイル端末で表示する列数。デフォルトは2。 |
title |
文字列 (String) | 任意のタイトルテキスト。指定された場合はタイトルコンポーネントが表示されます。 |
description |
文字列 (String) | 任意の説明テキスト（Markdown形式対応）。説明内容としてレンダリングされます。 |
toolbar |
オブジェクト (Object) | ツールバー設定オブジェクト。上部の操作ボタンを定義するために使用します。 |
record_view |
オブジェクト (Object) | 単一レコードのビュー（表示）テンプレート定義。各データ項目のレンダリング方法を記述します。 |
注：
record_viewはコントロール設定オブジェクトであり、bricks.widgetBuildによって各データ項目の子コントロールが生成されます。
主なイベント
| イベント名 | 発火条件 | 持たされるデータ |
|---|---|---|
record_click |
ユーザーが特定のレコードをクリックしたときに発火 | クリックされたレコードに対応するデータオブジェクト（user_data） |
command |
ツールバーボタンがクリックされ、toolbar_w 経由で送信されたコマンドイベント。command_handle により dispatch(name) として転送される |
コマンド名（toolbar の params.name より取得） |
説明：
dispatch('record_click', data)は外部にこのイベントをブロードキャストし、外部での監視・処理を可能にします。