Ant Design Vue教程

Ant Design Vue Select 属性和事件

Ant Design Vue Select 属性和事件列表,将列举如何使用Select的属性和事件。

属性用例

我们将以Select的标签模式为例,演示如何使用maxTagPlaceholder属性,官方文档该属性说明如下

属性名称说明参数
maxTagPlaceholder超过maxTagCount设置显示的标签数时,隐藏时显示的内容slot/function(omittedValues)

slot插槽作为参数的代码

<template>
  <a-select mode="tags" :maxTagCount="2" :maxTagTextLength="6" 
   style="width: 300px" placeholder="属性演示" >
    <a-icon slot="maxTagPlaceholder" type="smile" />
    <a-select-option  value="baidu.com">www.baidu.com</a-select-option>
    <a-select-option  value="itxst.com">www.itxst.com</a-select-option>
    <a-select-option  value="google.com">www.google.com</a-select-option>
    <a-select-option  value="mircosoft.com">www.mircosoft.com</a-select-option>
  </a-select>
</template>

function函数作为参数的代码

<template>
  <a-select mode="tags" :maxTagPlaceholder="() => {return '+++'}" :maxTagCount="2" 
  :maxTagTextLength="6" style="width: 300px" placeholder="属性演示" >
    <a-select-option  value="baidu.com">www.baidu.com</a-select-option>
    <a-select-option  value="itxst.com">www.itxst.com</a-select-option>
    <a-select-option  value="google.com">www.google.com</a-select-option>
    <a-select-option  value="mircosoft.com">www.mircosoft.com</a-select-option>
  </a-select>
</template>

在线试一试

属性列表

属性名称说明参数默认值
allowClear清除图标booleanfalse
autoClearSearchValue是否在选中项后清空搜索框,
只在 mode 为 multiple 或 tags 时有效。
booleantrue
autoFocus默认是否获取焦点booleanfalse
defaultActiveFirstOption是否默认高亮第一个选项。booleantrue
defaultValue指定默认选中项string|string[]|number|number[]
disabled是否禁用booleanfalse
dropdownClassName下拉菜单的 className 属性string-
dropdownMatchSelectWidth下拉菜单和选择器同宽booleantrue
dropdownRender自定义下拉框内容(menuNode: VNode, props) => VNode
dropdownStyle下拉菜单的 style 属性object
比如{width:'200px',height:'100px'}
dropdownMenuStyledropdown 菜单自定义样式object
filterOption 根据输入项进行筛选,返回ture表示显示function(inputValue, option)
firstActiveValue默认高亮的选项string|string[]
getPopupContainer菜单渲染父节点。默认渲染到 body 上,
如果你遇到菜单滚动定位问题,试试修改为滚动的区域,并相对其定位。
function(triggerNode)() => document.body
labelInValue是否把每个选项的 label 包装到 value 中,会把 Select 的 value 类型从 string 变为 {key: string, label: vNodes} 的格式booleanfalse
maxTagCount最多显示多少个 tag标签number-
maxTagPlaceholder隐藏 tag 时显示的内容slot/function(omittedValues)
maxTagTextLength最大显示的 tag 文本长度number
mode设置 Select 的模式为多选或标签'default' | 'multiple' | 'tags' | 'combobox'
notFoundContent当下拉列表为空时显示的内容string|slot 默认'Not Found'
optionFilterProp搜索时过滤对应的 option 属性,如设置为 children 表示对内嵌内容进行搜索stringvalue
optionLabelProp回填到选择框的 Option 的属性值,默认是 Option 的子元素。比如在子元素需要高亮效果时,此值可以设为 value。stringchildren (combobox 模式下为 value)
placeholder选择框默认文字string|slot
showSearch使单选模式可搜索booleanfalse
showArrow是否显示下拉小箭头booleantrue
size选择框大小,可选 large smallstringdefault
suffixIcon自定义的选择框后缀图标VNode | slot
removeIcon自定义的多选框清除图标VNode | slot
clearIcon自定义的多选框清空图标VNode | slot
menuItemSelectedIcon自定义当前选中的条目图标VNode | slot
tokenSeparators在 tags 和 multiple 模式下自动分词的分隔符string[]
value(v-model)指定当前选中的条目string|string[]|number|number[]
optionsoptions 数据,如果设置则不需要手动构造 selectOption 节点array<{value, label, [disabled, key, title]}>
defaultOpen是否默认展开下拉菜单boolean-
open是否展开下拉菜单boolean-


Catalog
快速入门 Dropdown 下拉菜单 Menu 导航菜单 Pagination 分页 Steps 步骤条 AutoComplete 自动填充 Cascader 级联选择 Checkbox 多选框 DatePicker 日期选择框 Input 输入框 InputNumber 数字输入框 Mentions 提及 Radio 单选框 Rate 评分组件 Select 下拉框 Select 下拉框用法 Select 下拉框联动 Select 下拉框多选 Select 下拉框分组 Select 搜索框 Select 属性和事件 Slider 滑动输入条 Switch 开关