Select

介紹使用 Select 下拉選項元件

Select 下拉選擇,用在讓使用者針對選取的資料做進一步的篩選,或是與選項按鈕一樣,選一個特定值。點擊按鈕會出現一個懸浮區域,裡面是一系列的選項,外觀與 Dropdown 相似,但與 Dropdown 最大的不同之處在於 Select 點擊選項後,值變成選項內容,並且關閉懸浮區域。

主題色

<bpa-select v-model="value" :options="options" />

大小

<bpa-select v-model="value" :options="options" size="small"/>

提示文字

<bpa-select v-model="value" :options="options" placeholder="placeholder"/>

禁用

<bpa-select v-model="value" :options="options" disabled/>

隱藏清除按鈕

<bpa-select v-model="value" :options="options" disabledClear/>

前綴與後綴

<bpa-select v-model="value" :options="options">
  <template v-slot:prefix>prefix</template>
  <template v-slot:affix>affix</template>
</bpa-select>

如果上層有”position: fixed”

<bpa-select v-model="value" :options="options" fixed @click="onClick"/>

在 bpa-form-item 裡

<bpa-form-item labelFor="bpa-select-{id}-btn">
	<bpa-select v-model="value" :options="options" :id="{id}" @click="onClick"/>
</bpa-form-item>

客製化列表寬度

<bpa-select v-model="value" :options="options" optionWidth="100px" @click="onClick"/>

多選

<bpa-select v-model="valueM" :options="options" multiple /> <!-- show all options -->
<bpa-select v-model="valueM" :options="options" multiple="accordion" /> <!-- show first option, others using "n+" -->

列表選項群組

{
  label: '第一群',
  type: 'group',
    options: [
      { label: 'label10', value: '10' },
      { label: 'label20', value: '20' },
      { label: 'label30', value: '30' }
    ]
  }
}
提示:
autocomplete:預設 0.8 秒後過濾列表選項
手動 search:使用 “@search”
<bpa-select v-model="value" :options="options" multiple :toolbar="['search']"/>

屬性

名稱ValueTypeDefault ValueRequired描述
idString隨機
sizesmall
large
String
v-modelstring | number | Array< string | number >✔️click outside mask to close dialog or not
optionsArray<{ label: string, value: any }> | Array<{ label: string, type: ‘group’, options: Option[] >✔️下拉選項中的選項,或群組選項
disabledBooleanfalse
disabledClearBooleanfalse不顯示清空按鈕
placeholderString請選擇/Enter✔️
themeprimary
success
warning
danger
primary-ghost
success-ghost
warning-ghost
danger-ghost
String
optionWidthString
fixedBooleanfalse
v-slot:prefix提示文字的前方客製化區域
v-slot:affix提示文字的前方客製化區域
toolbarArray<‘search’>工具列,目前支援 搜尋search
multiple‘accordion’ or undefined多選,無需給值,若欲摺疊選項則給值 collapse
listboxClassString可以在 listbox 增加 classname
bpa-select Props

事件

名稱Paramaters描述
searchkeyword搜尋輸入值改變時
input選取項目改變
bpa-select Events

演示