天天看點
傳回

微信小程式之元件Picker[五類選擇器[【預設】普通選擇器，多列選擇器，時間選擇器，日期選擇器，省市選擇器]]

Picker

從底部彈起的滾動選擇器，現支援五種選擇器，通過mode來區分，分别是普通選擇器，多列選擇器，時間選擇器，日期選擇器，省市區選擇器，預設是普通選擇器。

普通選擇器：mode = selector

屬性名 類型 預設值 說明 最低版本
range Array / Object Array [] mode為 selector 或 multiSelector 時，range 有效
range-key String 當 range 是一個 Object Array 時，通過 range-key 來指定 Object 中 key 的值作為選擇器顯示内容
value Number value 的值表示選擇了 range 中的第幾個（下标從 0 開始）
bindchange EventHandle value 改變時觸發 change 事件，event.detail = {value: value}
disabled Boolean false 是否禁用
bindcancel EventHandle 取消選擇或點遮罩層收起 picker 時觸發 ​​1.9.90​​

多列選擇器：mode = multiSelector（最低版本：​​1.4.0​​）

屬性名 類型 預設值 說明 最低版本
range 二維Array / 二維Object Array [] mode為 selector 或 multiSelector 時，range 有效。二維數組，長度表示多少列，數組的每項表示每列的資料，如​

​[["a","b"], ["c","d"]]​

 ​
range-key String 當 range 是一個 二維Object Array 時，通過 range-key 來指定 Object 中 key 的值作為選擇器顯示内容
value Array [] value 每一項的值表示選擇了 range 對應項中的第幾個（下标從 0 開始）
bindchange EventHandle value 改變時觸發 change 事件，event.detail = {value: value}
bindcolumnchange EventHandle 某一列的值改變時觸發 columnchange 事件，event.detail = {column: column, value: value}，column 的值表示改變了第幾列（下标從0開始），value 的值表示變更值的下标
bindcancel EventHandle 取消選擇時觸發 ​​1.9.90​​
disabled Boolean false 是否禁用

時間選擇器：mode = time

屬性名 類型 預設值 說明 最低版本
value String 表示選中的時間，格式為"hh:mm"
start String 表示有效時間範圍的開始，字元串格式為"hh:mm"
end String 表示有效時間範圍的結束，字元串格式為"hh:mm"
bindchange EventHandle value 改變時觸發 change 事件，event.detail = {value: value}
bindcancel EventHandle 取消選擇時觸發 ​​1.9.90​​
disabled Boolean false 是否禁用

日期選擇器：mode = date

屬性名 類型 預設值 說明 最低版本
value String 表示選中的日期，格式為"YYYY-MM-DD"
start String 表示有效日期範圍的開始，字元串格式為"YYYY-MM-DD"
end String 表示有效日期範圍的結束，字元串格式為"YYYY-MM-DD"
fields String day 有效值 year,month,day，表示選擇器的粒度
bindchange EventHandle value 改變時觸發 change 事件，event.detail = {value: value}
bindcancel EventHandle 取消選擇時觸發 ​​1.9.90​​
disabled Boolean false 是否禁用

fields 有效值：

值 說明
year 選擇器粒度為年
month 選擇器粒度為月份
day 選擇器粒度為天

省市區選擇器：mode = region（最低版本：​​1.4.0​​）

屬性名 類型 預設值 說明 最低版本
value Array [] 表示選中的省市區，預設選中每一列的第一個值
custom-item String 可為每一列的頂部添加一個自定義的項 ​​1.5.0​​
bindchange EventHandle value 改變時觸發 change 事件，event.detail = {value: value, code: code, postcode: postcode}，其中字段code是統計用區劃代碼，postcode是郵政編碼
bindcancel EventHandle 取消選擇時觸發 ​​1.9.90​​
disabled Boolean false 是否禁用

示例代碼：

​​在開發者工具中預覽效果​​

<view class="section">
  <view class="section__title">普通選擇器</view>
  <picker bindchange="bindPickerChange" value="{{index}}" range="{{array}}">
    <view class="picker">
      目前選擇：{{array[index]}}
    </view>
  </picker>
</view>
<view class="section">
  <view class="section__title">多列選擇器</view>
  <picker mode="multiSelector" bindchange="bindMultiPickerChange" bindcolumnchange="bindMultiPickerColumnChange" value="{{multiIndex}}" range="{{multiArray}}">
    <view class="picker">
      目前選擇：{{multiArray[0][multiIndex[0]]}}，{{multiArray[1][multiIndex[1]]}}，{{multiArray[2][multiIndex[2]]}}
    </view>
  </picker>
</view>
<view class="section">
  <view class="section__title">時間選擇器</view>
  <picker mode="time" value="{{time}}" start="09:01" end="21:01" bindchange="bindTimeChange">
    <view class="picker">
      目前選擇: {{time}}
    </view>
  </picker>
</view>

view class=“section”>

<view class=“section__title”>日期選擇器</view>

<picker mode=“date” value="{{date}}" start=“2015-09-01” end=“2017-09-01” bindchange=“bindDateChange”>

<view class=“picker”>

目前選擇: {{date}}

</view>

</picker>

</view>

<view class=“section”>

<view class=“section__title”>省市區選擇器</view>

<picker mode=“region” bindchange=“bindRegionChange” value="{{region}}" custom-item="{{customItem}}">

<view class=“picker”>

目前選擇：{{region[0]}}，{{region[1]}}，{{region[2]}}

</view>

</picker>

</view>

Page({
  data: {
    array: ['美國', '中國', '巴西', '日本'],
    objectArray: [
      {
        id: 0,
        name: '美國'
      },
      {
        id: 1,
        name: '中國'
      },
      {
        id: 2,
        name: '巴西'
      },
      {
        id: 3,
        name: '日本'
      }
    ],
    index: 0,
    multiArray: [['無脊柱動物', '脊柱動物'], ['扁性動物', '線形動物', '環節動物', '軟體動物', '節肢動物'], ['豬肉縧蟲', '吸血蟲']],
    objectMultiArray: [
      [
        {
          id: 0,
          name: '無脊柱動物'
        },
        {
          id: 1,
          name: '脊柱動物'
        }
      ], [
        {
          id: 0,
          name: '扁性動物'
        },
        {
          id: 1,
          name: '線形動物'
        },
        {
          id: 2,
          name: '環節動物'
        },
        {
          id: 3,
          name: '軟體動物'
        },
        {
          id: 3,
          name: '節肢動物'
        }
      ], [
        {
          id: 0,
          name: '豬肉縧蟲'
        },
        {
          id: 1,
          name: '吸血蟲'
        }
      ]
    ],
    multiIndex: [0, 0, 0],
    date: '2016-09-01',
    time: '12:01',
    region: ['廣東省', '廣州市', '海珠區'],
    customItem: '全部'
  },
  bindPickerChange: function(e) {
    console.log('picker發送選擇改變，攜帶值為', e.detail.value)
    this.setData({
      index: e.detail.value
    })
  },
  bindMultiPickerChange: function (e) {
    console.log('picker發送選擇改變，攜帶值為', e.detail.value)
    this.setData({
      multiIndex: e.detail.value
    })
  },
  bindMultiPickerColumnChange: function (e) {
    console.log('修改的列為', e.detail.column, '，值為', e.detail.value);
    var data = {
      multiArray: this.data.multiArray,
      multiIndex: this.data.multiIndex
    };
    data.multiIndex[e.detail.column] = e.detail.value;
    switch (e.detail.column) {
      case 0:
        switch (data.multiIndex[0]) {
          case 0:
            data.multiArray[1] = ['扁性動物', '線形動物', '環節動物', '軟體動物', '節肢動物'];
            data.multiArray[2] = ['豬肉縧蟲', '吸血蟲'];
            break;
          case 1:
            data.multiArray[1] = ['魚', '兩栖動物', '爬行動物'];
            data.multiArray[2] = ['鲫魚', '帶魚'];
            break;
        }
        data.multiIndex[1] = 0;
        data.multiIndex[2] = 0;
        break;
      case 1:
        switch (data.multiIndex[0]) {
          case 0:
            switch (data.multiIndex[1]) {
              case 0:
                data.multiArray[2] = ['豬肉縧蟲', '吸血蟲'];
                break;
              case 1:
                data.multiArray[2] = ['蛔蟲'];
                break;
              case 2:
                data.multiArray[2] = ['螞蟻', '螞蟥'];
                break;
              case 3:
                data.multiArray[2] = ['河蚌', '蝸牛', '蛞蝓'];
                break;
              case 4:
                data.multiArray[2] = ['昆蟲', '甲殼動物', '蛛形動物', '多足動物'];
                break;
            }
            break;
          case 1:
            switch (data.multiIndex[1]) {
              case 0:
                data.multiArray[2] = ['鲫魚', '帶魚'];
                break;
              case 1:
                data.multiArray[2] = ['青蛙', '娃娃魚'];
                break;
              case 2:
                data.multiArray[2] = ['蜥蜴', '龜', '壁虎'];
                break;
            }
            break;
        }
        data.multiIndex[2] = 0;
        console.log(data.multiIndex);
        break;
    }
    this.setData(data);
  },
  bindDateChange: function(e) {
    console.log('picker發送選擇改變，攜帶值為', e.detail.value)
    this.setData({
      date: e.detail.value
    })
  },
  bindTimeChange: function(e) {
    console.log('picker發送選擇改變，攜帶值為', e.detail.value)
    this.setData({
      time: e.detail.value
    })
  },
  bindRegionChange: function (e) {
    console.log('picker發送選擇改變，攜帶值為', e.detail.value)
    this.setData({
      region: e.detail.value
    })
  }
})
微信小程式 picker 選擇器 預設值 多列
上一篇: 中國大陸IP段（僅大陸地區）【2020-07-24】
下一篇: Gogs部署

繼續閱讀