Select 选择器


基础用法

基本用法,可添加 disabled 属性禁用选择器

Select选择器 - 图1

  1. <at-select v-model="model1" style="width:100px">
  2. <at-option value="1">深圳</at-option>
  3. <at-option value="2">广州广州广州广州广州广州广州广州广州广州</at-option>
  4. <at-option value="3">上海</at-option>
  5. <at-option value="4">北京</at-option>
  6. <at-option value="5">成都</at-option>
  7. </at-select>
  8. <at-select v-model="model2" style="width:100px">
  9. <at-option value="1">深圳</at-option>
  10. <at-option value="2">广州</at-option>
  11. </at-select>
  12. <at-select v-model="model2" disabled style="width:100px">
  13. <at-option value="1">深圳</at-option>
  14. <at-option value="2">广州</at-option>
  15. </at-select>

不同尺寸

可设置 size 属性控制选择器大小,提供三种尺寸:largenormalsmall

Select选择器 - 图2

  1. <at-select v-model="model3" size="small" style="width: 100px">
  2. <at-option value="1">深圳</at-option>
  3. <at-option value="2">广州</at-option>
  4. <at-option value="3">上海</at-option>
  5. <at-option value="4">北京</at-option>
  6. <at-option value="5">成都</at-option>
  7. </at-select>
  8. <at-select v-model="model3" size="normal" style="width: 100px">
  9. <at-option value="1">深圳</at-option>
  10. <at-option value="2">广州</at-option>
  11. <at-option value="3">上海</at-option>
  12. <at-option value="4">北京</at-option>
  13. <at-option value="5">成都</at-option>
  14. </at-select>
  15. <at-select v-model="model3" size="large" style="width: 100px">
  16. <at-option value="1">深圳</at-option>
  17. <at-option value="2">广州</at-option>
  18. <at-option value="3">上海</at-option>
  19. <at-option value="4">北京</at-option>
  20. <at-option value="5">成都</at-option>
  21. </at-select>

可清空选择

设置 clearable 属性可清空已选项,仅适用于单选选择器

Select选择器 - 图3

  1. <at-select v-model="model4" clearable size="large" style="width: 100px">
  2. <at-option value="1">深圳</at-option>
  3. <at-option value="2">广州</at-option>
  4. <at-option value="3">上海</at-option>
  5. <at-option value="4">北京</at-option>
  6. <at-option value="5">成都</at-option>
  7. </at-select>

分组选项

选项可通过使用 AtOptionGroup 组件进行分组,分组的名称可使用属性 label 设置

Select选择器 - 图4

  1. <at-select v-model="model5" style="width: 100px">
  2. <at-option-group label="广东省">
  3. <at-option value="1">深圳</at-option>
  4. <at-option value="2">广州</at-option>
  5. <at-option value="3">珠海</at-option>
  6. </at-option-group>
  7. <at-option-group label="其他">
  8. <at-option value="4">上海</at-option>
  9. <at-option value="5">北京</at-option>
  10. <at-option value="6" disabled>成都</at-option>
  11. <at-option value="7">昆明</at-option>
  12. <at-option value="8">杭州</at-option>
  13. </at-option-group>
  14. </at-select>

自定义模板

可自定义 AtOption 显示的内容,但是请给 AtOption 添加 label 属性,这可以让选择器优先显示选项的 label 值,而不是内容本身

Select选择器 - 图5

  1. <at-select v-model="model6" style="width: 140px">
  2. <at-option value="1" label="深圳"><span>深圳</span><span style="float: right;opacity: .6;font-size: 0.8em;">Shenzhen</span></at-option>
  3. <at-option value="2" label="广州"><span>广州</span><span style="float: right;opacity: .6;font-size: 0.8em;">Guangzhou</span></at-option>
  4. <at-option value="3" label="上海"><span>上海</span><span style="float: right;opacity: .6;font-size: 0.8em;">Shanghai</span></at-option>
  5. <at-option value="4" label="北京"><span>北京</span><span style="float: right;opacity: .6;font-size: 0.8em;">Beijin</span></at-option>
  6. <at-option value="5" label="成都"><span>成都</span><span style="float: right;opacity: .6;font-size: 0.8em;">Chengdu</span></at-option>
  7. </at-select>

多选列表

设置 multiple 属性可开启多项选择器,此时绑定的 model 将接受数组类型的数据

Select选择器 - 图6

  1. <at-select v-model="model7" multiple style="width: 240px">
  2. <at-option value="1">深圳</at-option>
  3. <at-option value="2">广州</at-option>
  4. <at-option value="3">上海</at-option>
  5. <at-option value="4">北京</at-option>
  6. <at-option value="5">成都</at-option>
  7. </at-select>

可搜索列表

添加 filterable 属性开启选择列表的可搜索功能

Select选择器 - 图7

  1. <at-select v-model="model8" filterable size="large" style="width: 240px">
  2. <at-option value="1">深圳</at-option>
  3. <at-option value="2">广州</at-option>
  4. <at-option value="3">上海</at-option>
  5. <at-option value="4">北京</at-option>
  6. <at-option value="5">成都</at-option>
  7. <at-option value="6">厦门</at-option>
  8. <at-option value="7">昆明</at-option>
  9. <at-option value="8">杭州</at-option>
  10. </at-select>

Select 参数

参数说明类型可选值默认值
value指定当前组件的 value 值,可通过 v-model 绑定String / Number / Array--
multiple是否支持多选Boolean-false
disabled是否禁用选择器Boolean-false
clearable是否支持清空功能Boolean-false
filterable是否支持搜索功能Boolean-false
placeholder选择器的占位文案String-请选择
size设置选择器的尺寸Stringlarge, normal, smallnormal
notFoundText搜索无结果的提示String-无匹配数据
placementdropdown 出现的位置Stringtop, bottombottom
valueWithLabel是否将 label 值一并返回,默认只返回 valueBoolean-false

Select 事件

事件名称说明返回值
on-change绑定的值变化时触发选中的选项值,类型为 StringNumber 或者 Array