DatetimePicker

时间日期选择器。

引入

  1. import { DatetimePicker } from 'we-vue'
  2. Vue.use(DatetimePicker)

例子

v-model 属性为组件的绑定值。

type 属性表示 datetime-picker 组件的类型,它有三个可能的值:

  • datetime: 日期时间选择器,可选择年、月、日、时、分,value 值为一个 Date 对象
  • date: 日期选择器,可选择年、月、日,value 值为一个 Date 对象
  • time: 时间选择器,可选择时、分,value 值为一个格式为 HH:mm 的字符串datetime-picker 提供了两个供外部调用的方法:openclose,分别用于打开和关闭选择器。
  1. <template>
  2. <w-datetime-picker
  3. ref="picker"
  4. type="time"
  5. v-model="pickerValue">
  6. </w-datetime-picker>
  7. </template>
  1. <script>
  2. export default {
  3. methods: {
  4. openPicker() {
  5. this.$refs.picker.open();
  6. }
  7. }
  8. };
  9. </script>

可以为选项提供自定义模板。模板须为一个包含了 {value} 的字符串,{value} 会被解析为相应选项的值。

  1. <w-datetime-picker
  2. v-model="pickerVisible"
  3. type="date"
  4. year-format="{value} 年"
  5. month-format="{value} 月"
  6. date-format="{value} 日">
  7. </w-datetime-picker>

当点击确认按钮时会触发 confirm 事件,参数为当前 value 的值。

<w-datetime-picker
  v-model="pickerVisible"
  type="time"
  @confirm="onConfirm">
</w-datetime-picker>
onConfirm (value) {
    console.log(value.toString())
}

API

参数说明类型可选值默认值
type组件的类型String'datetime', 'date', 'time''datetime'
cancelText取消按钮文本String'取消'
confirmText确定按钮文本String'确定'
startDate日期的最小可选值Date十年前的 1 月 1 日
endDate日期的最大可选值Date十年后的 12 月 31 日
startHour小时的最小可选值Number0
endHour小时的最大可选值Number23
yearFormat年份模板String'{value}'
monthFormat月份模板String'{value}'
dateFormat日期模板String'{value}'
hourFormat小时模板String'{value}'
minuteFormat分钟模板String'{value}'
visibleItemCount可见选项数Number7

Events

事件名称说明回调参数
cancel点击取消按钮时的回调函数
confirm点击确认按钮时的回调函数目前的选择值

Methods

方法名说明参数
open打开选择器
close关闭选择器