Selector
安装
局部注册
全局注册
import { Selector } from 'vux'
export default {
components: {
Selector
}
}
// 在入口文件全局引入
import Vue from 'vue'
import { Selector } from 'vux'
Vue.component('selector', Selector)
<group>
<selector title="title" v-model="value"></selector>
</group>
selector
只能在Group
中使用
在iOS
上,如果没有指定placeholder
也没有指定value
,会出现弹出选择框时默认选中第一个值,但是确定后依然没有选中的情况。因此对于iOS
,组件内部在列表项前面增加了一个空的option
,强制用户滑动选择一次以避免上面的问题。
属性
名字 | 类型 | 默认值 | 说明 | 版本要求 |
value | stringnumberobject | 表单值,使用v-model绑定 | — | |
title | string | 标题 | — | |
direction | string | 选项对齐方式,同原生 select 属性一致,可选值为 ltr(left-to-right,默认), rtl | — | |
options | array | 选项列表,可以为简单数组,或者 { key: KEY, value: VALUE } 结构的键值对数组。当使用键值对时,返回的value 为key 的值。 | — | |
name | string | 表单的name名字 | — | |
placeholder | string | 提示文字 | — | |
readonly | boolean | false | 是否不可选择 | — |
value-map | array | 设置键值对映射用以自动转换接口数据, 如 ['value', 'label'] | v2.7.2 |
事件
名字 | 参数 | 说明 | 版本要求 |
@on-change | (value) | 值变化时触发 | — |
方法
名字 | 参数 | 说明 | 版本要求 |
getFullValue | 获取当前完整值,在使用了 valueMap 里可以用该方法来获取当前选中值的原始对象 | v2.7.2 |
相关 issue
- #3431 [Bug Report] selector 无反应
- #2638 Selector的选项对齐方式direction的属性值无说明
- #2633 在group中使用selector和demo显示效果不一样的issue
- #2615 selector 建议将title的赋值,建议使用v-html,与x-input一致
- #2587 selector无法显示placeholder,并且会返回true
- #2565 打包后IOS 访问 selector组件的placeholder属性在不显示
- #2373 selector组件标题不支持html,
- #2288 表单中存在多个select在原生app上选中第一个会默认跳到第二个上
- #2281 Selector 组件在ios上有时会出现闪退现象
- #2202 selector组件点击出现黑色,下拉文字找不到
- #2141 【版本2.6.4】Selector的 placeholder 没有效果
- #2139 Selector 选择无法识别自定义json
- #2120 selector 變更下拉箭咀
- #2101 Selector 选项默认option,在value为null的时候不会触发
- #1792 selector组件是否可以让用户手动输入?
- #1465 selector和XInput的placeholder字体颜色
- #1239 Select组件的一些建议
- #880 selector组件的placeholder属性在ios中不显示
- #661 selector组件在 iOS 的微信中选择无效的问题
贡献者
该组件(包含文档)迭代次数 37,贡献人数 7
Estelle00airylandunclayemondora万刚lichunqianggreedying
发布日志
- 2.9.3 [fix] 修复direction=rtl时的中文括号显示异常 #2864
- v2.9.0 [fix] 修复新版本 vue 导致的 select 值问题 #2633 #2587
- v2.9.0 [enhance] 标题使用 v-html #2615
- v2.7.2 [feature] 支持 value-map 属性用以自动转换 API 数据 #2139
- v2.7.2 [feature] 支持 getFullValue 方法获取当中选中值的原始数据
- v2.7.0 [fix] 兼容服务端渲染
- v2.7.0 [fix] 修复值为 null 时 placeholder 没有显示的问题 #2101
- v2.3.3 [enhance] 设置 placeholder 颜色. #1465
- v2.2.2 [fix] 修复 label for 属性值缺失
- v2.2.1-rc.6 [fix] 修复 placeholder 逻辑问题. #1273
- v2.1.1-rc.14 [fix] 修复Selector不能设置name属性的问题#1133
- v2.1.1-rc.14 [enhance] Selector的value支持布尔型. @rbao