Skip to content

DatePickerPanel 日期选择器面板 beta ​

DatePickerPanel 是 DatePicker 的核心组件,可以单独使用,将日期选择器直接嵌入到页面中。

ts
import { createApp } from 'vue'
import { ElDatePickerPanel } from '@szhn/dh-design-pc'

const app = createApp()
app.use(ElDatePickerPanel)

规范 ​

  • 支持年、月、日、时间四种粒度的单选与范围选择。
  • 范围选择时,结束日期不得早于起始日期;非组合场景由组件自动拦截非法范围。
  • 日期时间类面板可通过 show-footer、show-now、show-confirm 展示底部操作区(「此刻」「清除」「确定」);年/月/日范围面板点选即生效,示例默认不展示底部。
  • 通过 app.use(DhDesignPc) 安装后,组件内置文案(月份、星期、面板按钮等)默认使用 zh-cn。

选择某一天 ​

以「日」为基本单位,基础的日期选择控件;右侧为 type="daterange" 的日期范围选择。

选择月份 ​

通过 type="month" 选择月份;右侧为 type="monthrange" 的月份范围选择。

选择年份 ​

通过 type="year" 选择年份;右侧为 type="yearrange" 的年份范围选择。

选择日期时间 ​

通过 type="datetime" 选择日期与时间;右侧为 type="datetimerange" 的日期时间范围选择。

API ​

Attributes ​

属性名说明类型默认值
model-value / v-model选中项绑定值Date / Date[] / string / number—
type显示类型'date' | 'datetime' | 'week' | 'month' | 'year' | 'dates' | 'months' | 'years' | 'daterange' | 'datetimerange' | 'monthrange' | 'yearrange'date
is-range是否为范围选择booleanfalse
value-format可选,绑定值的格式string—
date-format可选,日期显示格式string—
time-format可选,时间显示格式string—
default-value可选,默认选中的值Date / [Date, Date]—
default-time可选,范围选择的默认时间Date / [Date, Date]—
disabled是否禁用booleanfalse
disabled-date禁用日期的函数Function—
cell-class-name为日期单元格自定义类名Function—
shortcuts设置快捷选项Array—
show-now是否显示"此刻"按钮booleantrue
show-confirm是否显示"确定"按钮booleanfalse
show-footer是否显示底部booleanfalse
show-week-number是否显示周数booleanfalse
arrow-control是否使用箭头控制时间面板booleanfalse
unlink-panels范围选择时是否禁用两个面板联动booleanfalse
clearable是否可以清空booleantrue
border是否显示边框booleantrue
editable文本框是否可编辑booleantrue

Events ​

事件名说明类型
update:modelValue当绑定值变化时触发Function
change选中值变化时触发Function