본문으로 건너뛰기

구성 요소

콤보박스

입력하는 동안 옵션 목록을 필터링하는 텍스트 입력란입니다.

사용법

기본

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>

긴 목록

입력하면 옵션이 필터링됩니다. 이것이 선택 메뉴보다 콤보박스를 사용할 때 얻는 이점입니다.

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은 선택한 값을 제출하고, 표시되는 텍스트는 라벨로 남습니다.

Only people with access to this project are listed.
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/combobox
  • bsui/combobox-input
  • bsui/combobox-popup
  • bsui/combobox-option

속성

속성유형기본값
placeholder text Search...
name text —

bsui/combobox-input

이 블록은 속성을 받지 않습니다.

bsui/combobox-popup

이 블록은 속성을 받지 않습니다.

bsui/combobox-option

속성유형기본값
value text —
label text —