# SplicePanel 隔离面板日期选择器
SplicePanel 隔离面板日期选择器 ( 只对范围有效 ) (此组件只在v1.0.10或以上版本有效 )
# SplicePanel 概述
选择或输入日期,支持年、月、日期等类型,支持选择范围。
# SplicePanel 代码演示
# 基础用法
专为范围选择需要分割面板使用,如需单选或者一般范围选择,请使用 DatePicke 组件
controlRange
控制可选范围,selectRange
设置可选月份个数,默认为 1
# 只设置开始日期
范围选择时,绑定数组前一项表示为开始日期,后一项表示为结束日期,只设置前一项表示只设置开始日期
# 快捷方式(options)
设置属性 options
对象中的 shortcuts
可以设置快捷选项,详见示例代码。
其中 value 为函数,必须返回一个日期,如果是 daterange 类型,需要返回一个数组。
value 接收任何正确的日期格式,比如 2016-12-24 或 12/24/16 都是正确的。
# 不可选日期(options)
设置属性 options
对象中的 disabledDate
可以设置不可选择的日期。
disabledDate 是函数,参数为当前的日期,需要返回 Boolean 是否禁用这天。
# 带有确认操作
设置属性 confirm
,选择日期后,选择器不会主动关闭,需用户确认后才可关闭。
确认按钮并没有影响日期的正常选择。
# 手动控制组件
对于一些定制化的场景,可以使用 slot 配合参数 open
及事件来手动控制组件的显示状态,详见示例和 API。
# 日期选择器出现的位置
通过设置属性 placement
为 : 可选值为 top、top-start、top-end、bottom、bottom-start、bottom-end、left、left-start、left-end、right、right-start、right-end。
# 是否禁用/只读/编辑
disabled
为 true 时不能提交到后台,不能弹出日期选择器;readonly
为 true 时不能弹出选择器,但值可以提交到后台;editable
为 false 时,输入框不能编辑
# 事件使用实例
on-change
日期发生变化时触发;on-open-change
弹出日历和关闭日历时触发;on-ok
在 confirm 模式下有效,点击确定按钮时触发
# SplicePanel API
# SplicePanel props
属性 | 说明 | 类型 | 默认值 |
---|---|---|---|
value | 除可以设置单项开始值之外(如例子所示)和 DatePcker 组件范围选择时 value 使用方式一致 | Array | - |
controlRange | 是否开启选择范围控制 | Boolean | false |
selectRange | 选择范围月个数 | Number | 1 |
TIP
其他 api 使用方式和 datePicker 组件范围选择时使用方式一致