uni-app 内置组件:Picker

Picker 组件是一个通用的滚动选择器,用户可以在其中选择值,通常用于日期、时间或者任意预设的一组值。

API

Picker 组件的属性较多,这里介绍一些常用的:

属性列表

  • mode:选择器类型,有效值为selector, multiSelector, time, date, region
  • value:值的序号,当 modeselectormultiSelector 时,为数组的下标;当 modedatetime 时,为相应的字符串。
  • range:当 modeselector 时,range 为数组,用户需要从数组中选择数据;当 modemultiSelector 时,range 为二维数组,每列数据对应的数组。
  • range-key:当 range 是一个 Object Array 时,通过 range-key 可以指定 Object 中 key 的值作为选择器显示内容。
  • startend:当 modedate 时,可以设定可选择的日期范围。
  • fields:当 modedate 时,可选择年、月、日,有效值为year, month, day

事件列表

  • change:值改变时触发的事件,event.detail = {value: value}。
  • cancel:取消选择时触发的事件。
  • columnchange:当 modemultiSelector 时,滚动某一列的值改变时触发的事件。

示例

HTML 部分:

html 复制代码
<picker mode="selector" value="{{index}}" range="{{array}}" bindchange="bindPickerChange">
  <view class="picker">
    当前选择:{{array[index]}}
  </view>
</picker>

JavaScript 部分:

javascript 复制代码
Page({
  data: {
    array: ['美国', '中国', '巴西', '日本'],
    index: 0
  },
  bindPickerChange: function(e) {
    this.setData({
      index: e.detail.value
    })
  }
})

在这个例子中,用户可以通过滚动选择器选择 '美国', '中国', '巴西', '日本' 这四个选项之一。用户选择不同的选项,页面上会显示 当前选择: 后面跟随用户的选择。

更详细的内容请参考最新的 uni-app 官方文档

相关推荐
钝挫力PROGRAMER16 分钟前
Vue中选项式和组合式API的学习
javascript·vue.js
3秒一个大20 分钟前
Vue 任务清单开发:数据驱动 vs 传统 DOM 操作
前端·javascript·vue.js
an869500120 分钟前
vue自定义组件this.$emit(“refresh“);
前端·javascript·vue.js
o__A_A21 分钟前
渲染可配置报告模板+自适应宽度(vue3)
前端·vue.js
鹏北海22 分钟前
Vue 组件解耦实践:用回调函数模式替代枚举类型传递
前端·vue.js
San3023 分钟前
拒绝做 DOM 的“搬运工”:从 Vanilla JS 到 Vue 3 响应式思维的进化
javascript·vue.js·响应式编程
qq_427506081 小时前
基于Vue 3和Element Plus利用h、render函数写一个简单的tooltip局部or全局指令
前端·javascript·vue.js
m0_471199631 小时前
【vue】收银界面离线可用,本地缓存订单,网络恢复后同步
网络·vue.js·缓存
Maybyy2 小时前
如何在项目里面添加一个可以左右翻动并显示指定日期的日历
前端·vue.js