文档中心 > 店铺动态卡片-开发指引

date-picker

更新时间:2020/08/26 访问次数:5674

 

API

 

datePicker

参数 说明 类型 默认值
size 输入框尺寸

可选值:
'small', 'medium', 'large'
Enum 'medium'
state 输入框状态

可选值:
'success', 'loading', 'error'
Enum -
placeholder 输入提示 String -
value 日期值(受控)moment 对象 custom -
defaultValue 初始日期值,moment 对象 custom -
format 日期值的格式(用于限定用户输入和展示) String 'YYYY-MM-DD'
showTime 是否使用时间控件,传入 TimePicker 的属性 { defaultValue, format, ... } Object/Boolean false
resetTime 每次选择日期时是否重置时间(仅在 showTime 开启时有效) Boolean false
onChange 日期值改变时的回调

签名:
Function(value: MomentObject/String) => void
参数:
value: {MomentObject/String} 日期值
Function func.noop
disabled 是否禁用 Boolean -
hasClear 是否显示清空按钮 Boolean true
visible 弹层显示状态 Boolean -
defaultVisible 弹层默认是否显示 Boolean false

 

DatePicker.MonthPicker

参数 说明 类型 默认值
size 输入框尺寸

可选值:
'small', 'medium', 'large'
Enum 'medium'
state 输入框状态

可选值:
'success', 'loading', 'error'
Enum -
placeholder 输入提示 String -
value 日期值(受控)moment 对象 custom -
defaultValue 初始日期值,moment 对象 custom -
format 日期值的格式(用于限定用户输入和展示) String 'YYYY-MM'
onChange 日期值改变时的回调

签名:
Function(value: MomentObject/String) => void
参数:
value: {MomentObject/String} 日期值
Function func.noop
disabled 是否禁用 Boolean -
hasClear 是否显示清空按钮 Boolean true
visible 弹层显示状态 Boolean -
defaultVisible 弹层默认是否显示 Boolean -
onVisibleChange 弹层展示状态变化时的回调

签名:
Function(visible: Boolean, reason: String) => void
参数:
visible: {Boolean} 弹层是否显示
reason: {String} 触发弹层显示和隐藏的来源
Function func.noop

 

DatePicker.RangePicker

参数 说明 类型 默认值    
size 输入框尺寸

可选值:
'small', 'medium', 'large'
Enum 'medium'    
value 日期范围值数组 [moment, moment] Array -    
defaultValue 初始的日期范围值数组 [moment, moment] Array -    
format 日期格式 String 'YYYY-MM-DD'    
showTime 是否使用时间控件,支持传入 TimePicker 的属性 Object/Boolean false    
resetTime 每次选择是否重置时间(仅在 showTime 开启时有效) Boolean false    
onChange 日期范围值改变时的回调 [ MomentObject String, MomentObject String ]

签名:
Function(value: Array) => void
参数:
value: {Array} 日期值
Function func.noop
state 输入框状态

可选值:
'error', 'loading', 'success'
Enum -    
disabled 是否禁用 Boolean -    
hasClear 是否显示清空按钮 Boolean true    
visible 弹层显示状态 Boolean -    
defaultVisible 弹层默认是否显示 Boolean false    
onVisibleChange 弹层展示状态变化时的回调

签名:
Function(visible: Boolean, reason: String) => void
参数:
visible: {Boolean} 弹层是否显示
reason: {String} 触发弹层显示和隐藏的来源
Function func.noop    

 

DatePicker.YearPicker

参数 说明 类型 默认值
size 输入框尺寸

可选值:
'small', 'medium', 'large'
Enum 'medium'
state 输入框状态

可选值:
'success', 'loading', 'error'
Enum -
placeholder 输入提示 String -
value 日期值(受控)moment 对象 custom -
defaultValue 初始日期值,moment 对象 custom -
format 日期值的格式(用于限定用户输入和展示) String 'YYYY'
onChange 日期值改变时的回调

签名:
Function(value: MomentObject/String) => void
参数:
value: {MomentObject/String} 日期值
Function func.noop
disabled 是否禁用 Boolean -
hasClear 是否显示清空按钮 Boolean true
visible 弹层显示状态 Boolean -
defaultVisible 弹层默认是否显示 Boolean -
onVisibleChange 弹层展示状态变化时的回调

签名:
Function(visible: Boolean, reason: String) => void
参数:
visible: {Boolean} 弹层是否显示
reason: {String} 触发弹层显示和隐藏的来源
Function func.noop

  

Demo示例

 

示例

 

<view class="com-wrap">
    <view class="com-sub-title">基础使用</view>
    <date-picker class="block" />
    <range-picker class="block" />
    <month-picker class="block" />
    <year-picker class="block" />

    <view class="com-sub-title">默认值</view>
    <date-picker default-value="2019-01-01" class="block" />
    <range-picker default-value="{{['2019-01-01', '2019-02-02']}}"  class="block" />
    <month-picker default-value="2019-03" class="block" />
    <year-picker default-value="2019" class="block" />

    <view class="com-sub-title">禁用</view>
    <date-picker default-value="2019-01-01" class="block" disabled />
    <range-picker default-value="{{['2019-01-01', '2019-02-02']}}" disabled class="block" />
    
    <view class="com-sub-title">时间</view>
    <date-picker default-value="{{time}}" class="block" show-time="{{ format: 'HH:mm' }}" />
    
</view>

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部