# 9.8 选择器(Picker)

APP内置组件,选择器pick,pickDate,pickTime组件功能由原生实现,无需引入H5组件。

功能参数选择弹窗,弹窗的顶部两端为圆角:16 pt

# 单列选择(地址)

# 单列选择(温度)

# 双列选择(属性)

# 双列选择(时间)

# 三列选择联级(地址)

# 三列选择联级(日期)

# 多选项选择

# 应用示例

# 导入组件

const picker = weex.requireModule('picker')
1

实例:

# 基础用法

<template>
  <div class="wrapper">
    <dof-minibar
      title="Picker"
      background-color="#267AFF"
      text-color="#ffffff"
      :is-image="true"
      :left-button="leftButton"
    ></dof-minibar>
    <scroller class="scroller">
      <title title="Picker"></title>
      <category title="使用案例"></category>
      <div class="wrapper-main">
        <text class="subTitle">选择城市(单列选择)</text>
        <dof-cell title="城市" 
                  :has-top-border="true" 
                  :has-bottom-border="true" 
                  :right-text="city ? city : '请选择城市'" 
                  @dofCellClicked="pickCity">
        </dof-cell>

        <text class="subTitle">选择温度(单列选择)</text>
        <dof-cell  title="温度"
                  :has-top-border="true" 
                  :has-bottom-border="true" 
                  :right-text="tempreture ? tempreture + '℃' : '请选择温度'"
                  @dofCellClicked="pickTempreture">
        </dof-cell>

        <text class="subTitle">选择属性(多列选择)</text>
        <dof-cell title="属性" 
                  :has-top-border="true" 
                  :has-bottom-border="true" 
                  :right-text="attribute" 
                  @dofCellClicked="pickAttribute">
        </dof-cell>

        <text class="subTitle">选择地址(多列选择级联)</text>
        <dof-cell title="属性" 
                  :has-top-border="true" 
                  :has-bottom-border="true" 
                  :right-text="cascadedDesc" 
                  @dofCellClicked="pickCascade">
        </dof-cell>

        <text class="subTitle">选择日期</text>
        <dof-cell title="日期" 
                  :has-top-border="true" 
                  :has-bottom-border="true" 
                  :right-text="date ? date : '请选择日期'" 
                  @dofCellClicked="pickDate">
        </dof-cell>
        <text class="subTitle">选择日期</text>
        <dof-cell title="时间" 
                  :has-top-border="true" 
                  :has-bottom-border="true" 
                  :right-text="time ? time : '请选择时间'" 
                  @dofCellClicked="pickTime"> 
        </dof-cell>
      </div>
    </scroller>
  </div>
</template>

<script>
import { DofMinibar, DofCell } from 'dolphin-intl-ui'
import Category from 'src/_mods/catalog'
import Title from 'src/_mods/title.vue'
const modal = weex.requireModule('modal')
const picker = weex.requireModule('picker')

export default {
  components: {
    DofMinibar,
    DofCell,
    Title,
    Category
  },
  data() {
    return {
      leftButton: '/assets/image/header/back_white@2x.png',
      // index: 0,
      city: '', //city
      cityIndex: 0, //cityIndex
      tempreture: '110', //温度
      tempretureIndex: 0, //温度索引
      attribute: '请选择属性', //属性选择结果
      colorIndex: 0, //属性选择索引
      sizeIndex: 0, //属性选择索引
      cascadedDesc: '请选择属性', //地址选择
      cascadedItem: [{ id: '' }, { id: '' }, { id: '' }], //默认值  地址

      date: '', //日期选择
      time: '' //时间选择
    }
  },
  methods: {
    pickCity() {
      const items = ['北京', '上海', '广州', '深圳', 'NewYork', 'Tokyo', 'Paris', 'Milano']
      var that = this
      var pickItem = [
        {
          index: that.cityIndex,
          item: items,
          label: ''
        }
      ]
      picker.pick(
        {
          items: pickItem,
          headTitle: '选择城市', //标题 6.5.1支持
          cancelTxt: '取消', //取消按钮文字
          confirmTxt: '确定', //确定按钮文字,
          cancelTxtColor: '#000000', //取消颜色
          confirmTxtColor: '#000000', //标题颜色
        },
        event => {
          if (event.result == 'success') {
            var dataArr = event.data
              .replace('[', '')
              .replace(']', '')
              .split(',')
            that.cityIndex = dataArr[0]
            that.city = items[dataArr[0]]
          }
          modal.toast({
            message: `您选择了第${that.cityIndex}个城市,名字为${that.city}}`
          })
        }
      )
    },

    pickTempreture() {
      const items = ['106', '107', '108', '109', '110', '111', '112', '113', '114', '115']
      var that = this
      var pickItem = [
        {
          index: that.tempretureIndex,
          item: items,
          label: '℃'
        }
      ]
      picker.pick(
        {
          items: pickItem,
          headTitle: '选择温度', //标题
          cancelTxt: '取消', //取消按钮文字
          confirmTxt: '确定', //确定按钮文字,
          cancelTxtColor: '#000000', //取消颜色
          confirmTxtColor: '#000000', //标题颜色
        },
        event => {
          if (event.result == 'success') {
            var dataArr = event.data
              .replace('[', '')
              .replace(']', '')
              .split(',')
            that.tempretureIndex = dataArr[0]
            that.tempreture = items[dataArr[0]]
          }

          modal.toast({
            message: `您选择了第${that.tempretureIndex}个温度,温度为${that.tempreture}}`
          })
        }
      )
    },

    pickAttribute() {
      const itemsColor = ['红色', '白色', '粉色']
      const itemsSize = ['XL', 'L', 'M', 'S']
      var that = this
      var pickItem = [
        {
          index: that.colorIndex,
          item: itemsColor,
          label: '颜色'
        },
        {
          index: that.sizeIndex,
          item: itemsSize,
          label: '尺寸'
        }
      ]
      picker.pick(
        {
          items: pickItem,
          headTitle: '选择颜色和尺寸', //标题
          cancelTxt: '取消', //取消按钮文字
          confirmTxt: '确定', //确定按钮文字,
          cancelTxtColor: '#000000', //取消颜色
          confirmTxtColor: '#000000', //标题颜色
        },
        event => {
          if (event.result == 'success') {
            var data = event.data
            var dataArr = data
              .replace('[', '')
              .replace(']', '')
              .split(',')
            that.colorIndex = dataArr[0]
            that.sizeIndex = dataArr[1]
            that.attribute = itemsColor[dataArr[0]] + ',' + itemsSize[dataArr[1]]
          }
          modal.toast({
            message: `that.colorIndex:${that.colorIndex},that.sizeIndex:${that.sizeIndex},that.attribute:${that.attribute}}`
          })
        }
      )
    },

    pickCascade() {
      let pickCascadeItem = [
        {
          index: this.cascadedItem[0].id || 2,
          label: '省'
        },
        {
          index: this.cascadedItem[1].id || 22,
          label: '市'
        },
        {
          index: this.cascadedItem[2].id || 222,
          // label: "区/县",
          label: ''
        }
      ]
      let pickItemMap = [
        { id: 1, pId: 0, name: '北京' },
        { id: 101, pId: 1, name: '北京' },
        { id: 1011, pId: 101, name: '朝阳区' },
        { id: 1012, pId: 101, name: '密云区' },
        { id: 2, pId: 0, name: '广东' },
        { id: 201, pId: 2, name: '广州' },
        { id: 2011, pId: 201, name: '天河区' },
        { id: 2012, pId: 201, name: '越秀区' },
        { id: 202, pId: 2, name: '深圳' },
        { id: 2021, pId: 202, name: '罗湖区' },
        { id: 2022, pId: 202, name: '福田区' },
        { id: 3, pId: 0, name: '广西' },
        { id: 301, pId: 3, name: '南宁' },
        { id: 3011, pId: 301, name: '宾阳县' },
        { id: 3012, pId: 301, name: '横县' },
        { id: 302, pId: 3, name: '北海' },
        { id: 3021, pId: 302, name: '海城区' },
        { id: 3022, pId: 302, name: '银海区' }
      ]
      picker.pickCascade(
        {
          items: pickCascadeItem,
          itemMaps: pickItemMap,
          headTitle: '选择地址', //取消和确定中间那标题
          cancelTxt: '取消', //取消按钮文字
          confirmTxt: '确定', //确定按钮文字,
          cancelTxtColor: '#000000', //取消颜色
          confirmTxtColor: '#000000', //标题颜色
          columnRatios:[1,2,3]   //各列的比例关系
        },
        event => {
          if (event.result == 'success') {
            this.cascadedItem = JSON.parse(event.data)
            let tempStr = ''
            for (let i = 0; i < this.cascadedItem.length; i++) {
              tempStr += this.cascadedItem[i].name + ','
            }
            this.cascadedDesc = tempStr.substring(0, tempStr.length - 1)
          }

          modal.toast({
            message: `cascadedDesc:${that.cascadedDesc}`
          })
        }
      )
    },

    pickDate() {
      var self = this
      picker.pickDate(
        {
          value: this.date || '2016-11-28',
          max: '2029-11-28',
          min: '2015-11-28',
          headTitle: '选择日期', //标题
          cancelTxt: '取消', //取消按钮文字
          confirmTxt: '确定', //确定按钮文字,
          cancelTxtColor: '#000000', //取消颜色
          confirmTxtColor: '#000000', //标题颜色
          columnRatios: [3, 1, 2]
        },
        event => {
          var result = event.result
          if (result == 'success') {
            self.date = event.data
          }
        }
      )
      modal.toast({
        message: `self.date:${self.date}`
      })
    },

    pickTime() {
      picker.pickTime(
        {
          value: this.time,
          headTitle: '选择时间', //标题
          cancelTxt: '取消', //取消按钮文字
          confirmTxt: '确定', //确定按钮文字,
          cancelTxtColor: '#020F13', //取消颜色
          confirmTxtColor: '#020F13', //标题颜色
        },
        event => {
          if (event.result === 'success') {
            this.time = event.data
          }

          modal.toast({
            message: `this.time:${this.time}`
          })
        }
      )
    }
  }
}
</script>

<style scoped>
.wrapper {
  width: 750px;
}
</style>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332

# pick Attributes

Prop Type Required Default Description
items Array N - 选择项数组集合(注1)
itemMaps Array N - 级联关系树集合(注3),传入时启用级联模式
wheelList Array N - 选择项数组集合
index Number N - 数据项的索引坐标
headTitle String N - 标题
confirmTxt String N - 确认按钮文字
cancelTxt String N - 取消按钮文字
confirmTxtColor String N #000000 确认按钮文字颜色
cancelTxtColor String N #000000 取消按钮文字颜色
columnRatios Array N [2, 1, 3] 各列的比例关系
titleColor String N #8A8A8F 标题栏文字颜色
titleBgColor String N - 标题栏背景色
subTitle String N - 子标题
subTitleColor String N - 子标题文字颜色
subTitleBgColor String N - 子标题背景色
selectionColor String N - 选中行背景颜色
height Number N - picker高度
pickerBgColor String N - picker背景颜色
viewColor String N - iOS全面屏手机,底部view颜色
spaceColor String N - picker和按钮之间间距颜色
unitColor String N - 单位字体颜色
lineColor String N - picker分割线颜色
textColor String N - picker文字颜色
cancleBgColor String N - 取消按钮背景色
confirmBgColor String N - 确认按钮背景色
cancleHightColor String N - 取消按钮高亮颜色
confirmHightColor String N - 确认按钮高亮颜色
btnLineColor String N - 按钮之间的分割线颜色
cornerRadius String N 16 边框圆角, ^8.20支持

# 注1 items属性

items 是一个数组,数组中的每个元素是一个对象,包含以下属性:

Prop Type Required Default Description
index Number Y 0 数据项的索引坐标
item Array N [] 数据项数组
label String N - 数据项单位
isLoop Number N 0 是否循环滚动,1为是,0为否

# pickCascade Attributes

Prop Type Required Default Description
items Array N - 选择项数组集合(注2)
itemMaps Array N 注3 级联关系树集合(~v4.3.0):第一列的pId为0;每项都有一个唯一的id; 用pId关联前一列的项;
headTitle String N - 标题
confirmTxt String N - 确认按钮文字
cancelTxt String N - 取消按钮文字
confirmTxtColor String N #000000 确认按钮文字颜色
cancelTxtColor String N #000000 取消按钮文字颜色
columnRatios Array N [2, 1, 3] 各列的比例关系
subTitle String N - 子标题
subTitleColor String N - 子标题文字颜色
subTitleBgColor String N - 子标题背景色
selectionColor String N - 选中行背景颜色
height Number N - picker高度
pickerBgColor String N - picker背景颜色
spaceColor String N - picker和按钮之间间距颜色
unitColor String N - 单位字体颜色
lineColor String N - picker分割线颜色
textColor String N - picker文字颜色
cancleBgColor String N - 取消按钮背景色
confirmBgColor String N - 确认按钮背景色
cancleHightColor String N - 取消按钮高亮颜色
confirmHightColor String N - 确认按钮高亮颜色
btnLineColor String N - 按钮之间的分割线颜色
titleColor String N - 标题栏文字颜色
titleBgColor String N - 标题栏背景色
viewColor String N - iOS全面屏手机,底部view颜色
cornerRadius String N - 边框圆角, ^8.20支持

# 注2 pickCascade items属性

items 是一个数组,数组中的每个元素是一个对象,包含以下属性:

Prop Type Required Default Description
index Number Y 0 数据项的索引坐标
label String N - 数据项单位
isLoop Number N 0 是否循环滚动,1为是,0为否

# 注3 itemMaps属性

itemMaps 是一个数组,数组中的每个元素是一个对象,包含以下属性:

Prop Type Required Default Description
id Number Y - 唯一标识符
pId Number Y - 父节点id,第一列的pId为0
name String Y - 显示名称

示例:

[
    { id: 1, pId: 0, name: '北京' },
    { id: 11, pId: 1, name: '北京' },
    { id: 111, pId: 11, name: '朝阳区' },
    { id: 112, pId: 11, name: '密云区' },
    { id: 2, pId: 0, name: '广东' }
]
1
2
3
4
5
6
7

# pickDate Attributes

Prop Type Required Default Description
value String Y - date picker 选中的值,date 的字符串格式为yyyy-MM-dd
max String N - date 的最大值,字符串格式为yyyy-MM-dd
min String N - date 的最小值,字符串格式为yyyy-MM-dd
headTitle String N - 标题
confirmTxt String N - 确认按钮文字
cancelTxt String N - 取消按钮文字
confirmTxtColor String N #000000 确认按钮文字颜色
cancelTxtColor String N #000000 取消按钮文字颜色
columnRatios Array N [2, 1, 3] 各列的比例关系
format String N "yyyy-MM-dd" 日期顺序和格式
isLoop Boolean N false pickerView是否循环展示
selectedRowBgColor String N - 选中行背景颜色
label String N - 年月日时分秒标签,以"-"为分隔符
pickerBgColor String N - picker背景颜色
viewColor String N - iOS全面屏手机,底部view颜色
spaceColor String N - picker和按钮之间间距颜色
unitColor String N - 单位字体颜色
lineColor String N - picker分割线颜色
textColor String N - 文字颜色
cancleBgColor String N - 取消按钮背景色
confirmBgColor String N - 确认按钮背景色
cancleHightColor String N - 取消按钮高亮颜色
confirmHightColor String N - 确认按钮高亮颜色
btnLineColor String N - 按钮之间的分割线颜色
titleColor String N - 标题栏文字颜色
titleBgColor String N - 标题栏背景色
cornerRadius String N 16 边框圆角, ^8.20支持
format说明:
yyyy : 代表年(不去区分大小写) 假设年份为 2017
  "y" , "yyy" , "yyyy" 匹配的都是4位完整的年 如 : "2017";
  "yy" 匹配的是年分的后两位 如 : "15";
  超过4位,会在年份前面加"0"补位 如 "YYYYY"对应"02017"

MM : 代表月(只能使用大写) 假设月份为 9
  "M" 对应 "9"
  "MM" 对应 "09"
  "MMM" 对应 "Sep"
  "MMMM" 对应 "Sep"
  超出3位,仍然对应 "September"

dd : 代表日(只能使用小写) 假设为13号
  "d" , "dd" 都对应 "13"
  超出2位,会在数字前面加"0"补位. 例如 "dddd" 对应 "0013"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# pickTime Attributes

Prop Type Required Default Description
value String Y - time picker 选中的值,date 的字符串格式为 HH:mm
headTitle String N - 标题
confirmTxt String N - 确认按钮文字
cancelTxt String N - 取消按钮文字
confirmTxtColor String N #000000 确认按钮文字颜色
cancelTxtColor String N #000000 取消按钮文字颜色
columnRatios Array N [2, 1, 3] 各列的比例关系
isLoop Boolean N false pickerView是否循环展示
selectedRowBgColor String N - 选中行背景颜色
label String N - 年月日时分秒标签,以"-"为分隔符
pickerBgColor String N - picker背景颜色
viewColor String N - iOS全面屏手机,底部view颜色
spaceColor String N - picker和按钮之间间距颜色
unitColor String N - 单位字体颜色
lineColor String N - picker分割线颜色
textColor String N - 文字颜色
cancleBgColor String N - 取消按钮背景色
confirmBgColor String N - 确认按钮背景色
cancleHightColor String N - 取消按钮高亮颜色
confirmHightColor String N - 确认按钮高亮颜色
btnLineColor String N - 按钮之间的分割线颜色
titleColor String N - 标题栏文字颜色
titleBgColor String N - 标题栏背景色
cornerRadius String N - 边框圆角, ^8.20支持

# pickWetness Attributes

Prop Type Required Default Description
items Array N - 选择项数组集合(注4)
index Number N - 数据项的索引坐标
headTitle String N - 标题
confirmTxt String N - 确认按钮文字
cancelTxt String N - 取消按钮文字
confirmTxtColor String N #000000 确认按钮文字颜色
cancelTxtColor String N #000000 取消按钮文字颜色
columnRatios Array N [2, 1, 3] 各列的比例关系
titleColor String N - 标题栏文字颜色
titleBgColor String N - 标题栏背景色
subTitle String N - 子标题
subTitleColor String N - 子标题文字颜色
subTitleBgColor String N - 子标题背景色
selectionColor String N - 选中行背景颜色
height Number N - picker高度
pickerBgColor String N - picker背景颜色
viewColor String N - iOS全面屏手机,底部view颜色
spaceColor String N - picker和按钮之间间距颜色
unitColor String N - 单位字体颜色
lineColor String N - picker分割线颜色
textColor String N - picker文字颜色
cancleBgColor String N - 取消按钮背景色
confirmBgColor String N - 确认按钮背景色
cancleHightColor String N - 取消按钮高亮颜色
confirmHightColor String N - 确认按钮高亮颜色
btnLineColor String N - 按钮之间的分割线颜色
cornerRadius String N 16 边框圆角, ^8.20支持
rules Array N - 湿度规则数组(注5)
wheelList Array N - 选择项数组集合

# 注4 pickWetness items属性

items 是一个数组,数组中的每个元素是一个对象,包含以下属性:

Prop Type Required Default Description
index Number Y 0 数据项的索引坐标
item Array N [] 数据项数组
label String N - 数据项单位
isLoop Number N 0 是否循环滚动,1为是,0为否

# 注5 rules属性

rules 是一个数组,数组中的每个元素是一个对象,包含以下属性:

Prop Type Required Default Description
min Number Y - 最小值
max Number Y - 最大值
text String Y - 显示文本
textColor String N #8a8a8f 文本颜色

示例:

[
    {
        "min": 75,
        "max": 155,
        "text": "轻度污染",
        "textColor": "#ff0000"
    }
]
1
2
3
4
5
6
7
8

# showPick Attributes

showPick 对应的类为 MideaWeexShowPickerView,根据 type 参数选择不同的实现:

  • type=2 时使用 MideaPureDatePickerView 实现
  • 其他 type 时使用 MideaPurePickerView 实现
Prop Type Required Default Description
type Number N - picker类型(0:普通, 1:级联, 2:日期, 3:时间, 4:湿度)
wheelList Array N - 选择项数组集合(注6),type≠2时使用
itemMaps Array N - 级联关系树集合(注3),type=1时使用
value String N - 日期值,type=2时使用,格式为yyyy-MM-dd
min String N - 最小日期,type=2时使用,格式为yyyy-MM-dd
max String N - 最大日期,type=2时使用,格式为yyyy-MM-dd
headTitle String N - 标题
titleColor String N - 标题栏文字颜色
titleBgColor String N - 标题栏背景色
subTitle String N - 子标题
subTitleColor String N - 子标题文字颜色
subTitleBgColor String N - 子标题背景色
confirmTxt String N - 确认按钮文字
cancelTxt String N - 取消按钮文字
confirmTxtColor String N - 确认按钮文字颜色
cancelTxtColor String N - 取消按钮文字颜色
height Number N - picker高度
offsetX Number N - pick组件x偏移(防止内容太长显示不全),type≠2时使用
dividerColor String N - 分割线颜色
backgroundColor String N - 背景颜色
itemHeight Number N - 行高,type≠2时使用
selectedRowBgColor String N - 选中行背景颜色
isReCreate Boolean N false 是否重新创建,type≠2时使用
columnRatios Array N - 各列的比例关系
textColor String N - 文字颜色
unitColor String N - 单位字体颜色
label String N - 年月日时分秒标签,以"-"为分隔符,type=2时使用
pickerBgColor String N - picker背景颜色
viewColor String N - iOS全面屏手机,底部view颜色
spaceColor String N - picker和按钮之间间距颜色
cancleBgColor String N - 取消按钮背景色
confirmBgColor String N - 确认按钮背景色
cancleHightColor String N - 取消按钮高亮颜色
confirmHightColor String N - 确认按钮高亮颜色
btnLineColor String N - 按钮之间的分割线颜色
cornerRadius String N 16 边框圆角

# 注6 showPick wheelList属性

wheelList 是一个数组,数组中的每个元素是一个对象,包含以下属性:

Prop Type Required Default Description
index Number Y 0 数据项的索引坐标
itemList Array N [] 数据项数组
label String N - 数据项单位
isLoop Number N 0 是否循环滚动,1为是,0为否

# 主动关闭picker^8.20

picker.dismissPick()
1

# 方法回调

callback {function (ret)}:执行完读取操作后的回调函数。ret {Object} 为 callback 函数的参数,有两个属性:

  • result {string}:结果三种类型 success, cancel, error
  • data {string}:

TIP

  • pick单列选择,ret.data 格式如 : "[12]"
  • pick多列选择,ret.data 格式如 : "[1,4,5]"
  • pickDate,ret.data 格式如: "2017-12-28"
  • pickTime, ret.data格式如: "12:40"