• Selector
    • 安装
    • 属性
    • 事件
    • 方法
    • 相关 issue
    • 贡献者
    • 发布日志

    Selector

    Selector

    demo 原始链接demo 源码编辑文档组件源码

    selector - 图1

    二维码

    selector - 图2

    Install

    安装

    局部注册

    全局注册

    1. import { Selector } from 'vux'
    2. export default {
    3. components: {
    4. Selector
    5. }
    6. }

    1. // 在入口文件全局引入
    2. import Vue from 'vue'
    3. import { Selector } from 'vux'
    4. Vue.component('selector', Selector)
    1. <group>
    2. <selector title="title" v-model="value"></selector>
    3. </group>

    selector只能在Group中使用

    iOS上,如果没有指定placeholder也没有指定value,会出现弹出选择框时默认选中第一个值,但是确定后依然没有选中的情况。因此对于iOS,组件内部在列表项前面增加了一个空的option,强制用户滑动选择一次以避免上面的问题。

    API

    属性

    名字类型默认值说明版本要求
    valuestringnumberobject表单值,使用v-model绑定
    titlestring标题
    directionstring选项对齐方式,同原生 select 属性一致,可选值为 ltr(left-to-right,默认), rtl
    optionsarray选项列表,可以为简单数组,或者 { key: KEY, value: VALUE } 结构的键值对数组。当使用键值对时,返回的valuekey的值。
    namestring表单的name名字
    placeholderstring提示文字
    readonlybooleanfalse是否不可选择
    value-maparray设置键值对映射用以自动转换接口数据, 如 ['value', 'label']v2.7.2

    事件

    名字参数说明版本要求
    @on-change(value)值变化时触发

    方法

    名字参数说明版本要求
    getFullValue获取当前完整值,在使用了 valueMap 里可以用该方法来获取当前选中值的原始对象v2.7.2

    Issues

    相关 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

    Changelog

    发布日志

    • 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