bricks/docs/ja/accordion.md
2025-11-19 12:30:39 +08:00

2.8 KiB
Raw Permalink Blame History

アコーディオン

コントロール機能:アコーディオンは折りたたみ可能なパネルコントロールであり、ユーザーがタイトルボタンをクリックすることで、異なるコンテンツ領域の表示・非表示を切り替えることができます。複数のコンテンツブロックを整理し、画面スペースを節約する場合に一般的に使用されます。

タイプ:コンテナコントロール
親クラスコントロールbricks.VBox

初期化パラメータ

パラメータ名 説明
item_size String任意 各折りたたみ項目のタイトルの高さ。デフォルトは '25px'
items Array<Object> 折りたたみ項目のリスト。各オブジェクトは以下のプロパティを含みます:
- name: 項目の一意な識別子
- icon: ボタンの前に表示されるアイコン(任意)
- label: ボタンに表示されるテキスト
- content: 子コントロールの設定オブジェクトwidgettype など)、動的にコンテンツを構築するために使用
- refresh (Boolean, 任意): クリックするたびにコンテンツを再読み込みするかどうか
item_css String任意 タイトルボタンのCSSクラス名。デフォルトは 'accordion-button'
content_css String任意 コンテンツ領域のCSSクラス名。デフォルトは 'accordion-content'

例:

{
  item_size: '30px',
  items: [
    {
      name: 'panel1',
      label: '基本情報',
      icon: 'info',
      content: { widgettype: 'Label', text: 'ここに基本情報があります' }
    },
    {
      name: 'panel2',
      label: '設定',
      refresh: true,
      content: { widgettype: 'Form', fields: [...] }
    }
  ]
}

主なイベント

イベント名 発生タイミング コールバック引数 説明
click(内部バインド) ユーザーがいずれかの折りたたみ項目のタイトルボタンをクリックしたとき event.target.bricks_widget はクリックされた Button インスタンスを指す コンテンツの切り替えを制御する主要なイベント。内部で自動的にバインドされ、コンテンツの読み込みと表示を処理する

注意このコントロール自体はカスタムイベントAPIを外部に公開しませんが、その動作はButtonclickイベントに依存してコンテンツの切り替えを実現しています。開発者は子コントロールのイベントを監視することで、機能拡張を行うことができます。