コンポーネント
コンボボックス
入力に合わせて選択肢の一覧を絞り込むテキスト入力欄。
使い方
基本
WordPress
Astro
Laravel
HTML
<bs:bsui-combobox placeholder="Pick a framework">
<bs:bsui-combobox-input />
<bs:bsui-combobox-popup>
<bs:bsui-combobox-option value="wordpress" label="WordPress" />
<bs:bsui-combobox-option value="astro" label="Astro" />
<bs:bsui-combobox-option value="laravel" label="Laravel" />
</bs:bsui-combobox-popup>
</bs:bsui-combobox>長いリスト
入力すると選択肢が絞り込まれます。これがセレクトよりコンボボックスを使う利点です。
Lisbon
London
Berlin
Helsinki
Istanbul
Dubai
Singapore
Tokyo
Sydney
HTML
<bs:bsui-combobox name="timezone" placeholder="Search time zones">
<bs:bsui-combobox-input />
<bs:bsui-combobox-popup>
<bs:bsui-combobox-option value="lisbon" label="Lisbon" />
<bs:bsui-combobox-option value="london" label="London" />
<bs:bsui-combobox-option value="berlin" label="Berlin" />
<bs:bsui-combobox-option value="helsinki" label="Helsinki" />
<bs:bsui-combobox-option value="istanbul" label="Istanbul" />
<bs:bsui-combobox-option value="dubai" label="Dubai" />
<bs:bsui-combobox-option value="singapore" label="Singapore" />
<bs:bsui-combobox-option value="tokyo" label="Tokyo" />
<bs:bsui-combobox-option value="sydney" label="Sydney" />
</bs:bsui-combobox-popup>
</bs:bsui-combobox>フィールド内
name属性には選択した値が送信され、表示テキストにはラベルが残ります。
Ada Lovelace
Grace Hopper
Alan Turing
HTML
<bs:bsui-field>
<bs:bsui-field-label text="Assignee" />
<bs:bsui-combobox name="assignee" placeholder="Search teammates">
<bs:bsui-combobox-input />
<bs:bsui-combobox-popup>
<bs:bsui-combobox-option value="ada" label="Ada Lovelace" />
<bs:bsui-combobox-option value="grace" label="Grace Hopper" />
<bs:bsui-combobox-option value="alan" label="Alan Turing" />
</bs:bsui-combobox-popup>
</bs:bsui-combobox>
<bs:bsui-field-description text="Only people with access to this project are listed." />
</bs:bsui-field>構造
コンボボックスは以下のブロックで構成されます。それぞれ独立したブロックで、親の内部でのみレンダリングされます。
bsui/comboboxbsui/combobox-inputbsui/combobox-popupbsui/combobox-option
属性
| 属性 | タイプ | デフォルト |
|---|---|---|
placeholder | text | Search... |
name | text | — |
bsui/combobox-input
このブロックは属性を受け取りません。
bsui/combobox-popup
このブロックは属性を受け取りません。
bsui/combobox-option
| 属性 | タイプ | デフォルト |
|---|---|---|
value | text | — |
label | text | — |