# 下拉框 Select
当选项过多时,使用下拉菜单展示并选择内容。
# 基础用法
基础用法
适用广泛的基础单选
<title>基础用法</title>
<describe>适用广泛的基础单选</describe>
<template>
<hc-select :data="data" :text.sync="text" v-model="value" style="width: 200px;" clearable></hc-select>
</template>
<script>
export default {
data () {
return {
value: '',
text: '',
data: [
{ text: 'xx1', value: 'x1' },
{ text: 'xx2', value: 'x2' },
{ text: 'xx3', value: 'x3' },
{ text: 'xx4', value: 'x4' },
{ text: 'xx5', value: 'x5' }
],
}
}
}
</script>
# 下拉多选
下拉多选
适用性较广的基础多选,用 Tag 展示已选项
<title>下拉多选</title>
<describe>适用性较广的基础多选,用 Tag 展示已选项</describe>
<template>
<hc-select :data="data" multiple v-model="values" style="width: 200px;"></hc-select>
</template>
<script>
export default {
data () {
return {
values: [],
data: [
{ text: 'xx1', value: 'x1' },
{ text: 'xx2', value: 'x2' },
{ text: 'xx3', value: 'x3' },
{ text: 'xx4', value: 'x4' },
{ text: 'xx5', value: 'x5' }
]
}
}
}
</script>
# 可搜索
可搜索
可以利用搜索功能快速查找选项
<title>可搜索</title>
<describe>可以利用搜索功能快速查找选项</describe>
<template>
<hc-select :data="data" v-model="values" style="width: 200px;" :filterable="true"></hc-select>
</template>
<script>
export default {
data () {
return {
values: [],
data: [
{ text: 'a', value: 'x1' },
{ text: 'b', value: 'x2' },
{ text: 'c', value: 'x3' },
{ text: 'd', value: 'x4' },
{ text: 'e', value: 'x5' }
]
}
}
}
</script>
# 有禁用选项
禁用选项
可以禁用下拉框中的选项
<title>禁用选项</title>
<describe>可以禁用下拉框中的选项</describe>
<template>
<hc-select :data="data" v-model="values" style="width: 200px;" :filterable="true"></hc-select>
</template>
<script>
export default {
data () {
return {
values: [],
data: [
{ text: 'a', value: 'x1' , disabled: true},
{ text: 'b', value: 'x2' },
{ text: 'c', value: 'x3' },
{ text: 'd', value: 'x4' },
{ text: 'e', value: 'x5' }
]
}
}
}
</script>
# 创建新条目
创建新条目
允许用户创建新条目
<title>创建新条目</title>
<describe>允许用户创建新条目</describe>
<template>
<hc-select :data="data" v-model="values" style="width: 200px;" :allow-create="true"></hc-select>
</template>
<script>
export default {
data () {
return {
values: [],
data: [
{ text: 'a', value: 'x1' },
{ text: 'b', value: 'x2' },
{ text: 'c', value: 'x3' },
{ text: 'd', value: 'x4' },
{ text: 'e', value: 'x5' }
]
}
}
}
</script>
# 属性及事件
# HcSelect属性
属性 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
value | 当前值,支持v-model方式使用 | string | -- | -- |
placeholder | 为空提示 | string | -- | -- |
data | 备选项数据 | array | -- | -- |
multiple | 允许多选 | boolean | -- | false |
viewable | 是否查看状态 | boolean | -- | false |
disabled | 是否禁用 | boolean | -- | false |
clearable | 单选时是否可以清空选项 | boolean | -- | false |
filterable | 是否可搜索 | boolean | -- | false |
collapse-tags | 是否开启选项汇总,溢出时使用数字显示 | boolean | -- | false |
allow-create | 是否创建并选中选项中不存在的条目 | boolean | -- | false |
# HcSelect-data选项属性
属性 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
value | 当前选项值 | string | -- | -- |
text | 当前选项文本 | string | -- | -- |
disabled | 当前选项禁用 | boolean | -- | -- |
# HcSelect事件
事件 | 说明 | 回调参数 |
---|---|---|
change | 用户选择值确认时触发 | event.value :选中项的值event.text :选中项的文本 |
登录