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-


快速入门 Button 按钮 Affix 固钉 Breadcrumb 面包屑 Dropdown 下拉菜单 Dropdown 下拉菜单 Dropdown 展开隐藏方法 Dropdown 属性及事件 Menu 导航菜单 Menu 导航菜单 Menu 导航菜单属性及事件 Pagination 分页 Pagination 跳转 Pagination 自定义下拉选项 Pagination 选择每页数量 Pagination 自定义页码文字 Pagination 样式风格 Pagination 属性列表 Pagination 事件列表 Steps 步骤条 Steps 步骤条基本用法 Steps 自定义图标和html Steps 属性列表 AutoComplete 自动填充 AutoComplete 自动完成组件 AutoComplete 前端筛选函数 AutoComplete 自定义选项 AutoComplete Ajax服务器端数据 AutoComplete 查询模式 AutoComplete 属性列表 AutoComplete 事件 AutoComplete 方法列表 Cascader 级联选择 Cascader 基础用法 Cascader 搜索筛选 Cascader ajax服务器端加载 Cascader 样式及自定义图标 Cascader fieldNames 自定义字段 Cascader API属性及事件 Cascader 属性及事件Node.js版 Cascader 属性及事件浏览器版 Checkbox 多选框 Checkbox 多选框用法 Checkbox 自定义布局 Checkbox 全选反选 Checkbox 属性事件列表 DatePicker 日期选择框 DatePicker 日期选择框用法 DatePicker 设置不可选日期 DatePicker 选择时间 DatePicker 设置日期格式 DatePicker 日期范围选择 DatePicker 定制日期单元格 DatePicker 自定义渲染 DatePicker 属性和事件 Input 输入框 Input 输入框用法 Input 密码框 Input 图标 Input 搜索框 Input 格式化提示 Input 属性及事件列表 Input addonAfter属性 InputNumber 数字输入框 InputNumber 数字输入框 InputNumber 属性和事件 Mentions 提及 Mentions提及用法 Mentions 属性和事件 Radio 单选框 Radio 单选框用法 Radio 单选框分组 Radio 按钮样式 Radio 属性事件 Rate 评分组件 Rate 评分组件用法 Rate 属性和事件 Select 下拉框 Select 下拉框用法 Select 下拉框联动 Select 下拉框多选 Select 下拉框分组 Select 搜索框 Select 属性和事件 Slider 滑动输入条 Slider 滑动输入条 Slider 属性 afterChange 事件 change 拖动事件 Switch 开关 Switch 开关用法