# 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 组件范围选择时使用方式一致