Element Plus 实例详解（三）___Date Picker 日期选择

Element Plus 实例详解（三）

___Date Picker 日期选择

文章目录：

一、前言

二、搭建Element Plus试用环境

 1、搭建Vue3项目（基于Vite + Vue）

 2、安装Element Plus

三、Element Plus DatePicker 日期选择器功能

1、选择某一天

2、选择年、月、周、1个或多个日期

3、选择一段时间（日期范围选择）

四、官方资料中的各参数说明

五、总结

---

一、前言

 　　声明：不断有人冒我网名，自行转载我博客文章到其他地方，未免被其他的假鬼李鬼冒名造成不必要损失，现公布一下我个人的真实资料：我姓李，是奶奶级别的老。。。老姐姐，今年50岁了，女，广州。

　　我只有一个博客：csdn:  逆境清醒的博客_CSDN博客-python,前端特效实例源码,python turtle绘图集锦领域博主,https://blog.csdn.net/weixin_69553582?type=blog其他以逆境清醒自居的都是冒名的。除了在csdn上公开交流外（csdn博客留言，csdn动态），其他任何地方我都不会和别人有任何私下联系，请留意分辨真伪（包括在csdn用我账号登录的）。

逆境清醒

2023年3月25日

---

　　Element Plus 组件里Date Picker 日期选择，是常用的日期选择组件，用于选择或输入日期，提供了日期选择的基础用法、选择某一天、选择年、月、周、1个或多个日期、文选择一段时间（日期范围选择）等功能，本篇里我们一起来试用一下Element Plus 组件里Date Picker 日期选择组件。

二、搭建Element Plus试用环境

 1、搭建Vue3项目（基于Vite + Vue）

　　安装时请选择支持Typescript，本实例我安装在（C:\00program\vue\vuelearn\vueviteproject1）目录中，具体方法详见下面文章：

vue3 项目搭建教程（基于create-vue，vite，Vite + Vue）https://blog.csdn.net/weixin_69553582/article/details/129630880

 安装完成后打开浏览器：http://localhost:5173/  ,能正常显示以下页面：

 2、安装Element Plus

• NPM：npm install element-plus --save

详细参考：

Element Plus 实例详解系列（一）__安装设置https://blog.csdn.net/weixin_69553582/article/details/129701286

三、Element Plus DatePicker 日期选择器功能

在 SSR 场景下，

需要将组件包裹在 之中 (如: Nuxt) 和 SSG (e.g: VitePress).

1、选择某一天

• 以”日“为基本单位，基础的日期选择控件
• 基本单位由 type 属性指定。
• 通过 shortcuts 配置快捷选项， 通过 disabledDate 函数，来设置禁用掉的日期。

 实现效果：通过Element Plus DatePicker 日期选择器，选择某一天日期 (带快速选项)

​

​

​

​

完整代码：

2、选择年、月、周、1个或多个日期

实现效果：

​

​

 完整代码：

3、选择一段时间（日期范围选择）

• 在选择日期范围时，默认情况下左右面板会联动。
• 如果希望两个面板各自独立切换当前月份，可以使用 unlink-panels 属性解除联动。

实现效果：

​

​

​

​

 完整代码：

详细的数据类型，请查看下表

interface DateCell {
  column: number
  customClass: string
  disabled: boolean
  end: boolean
  inRange: boolean
  row: number
  selected: Dayjs
  isCurrent: boolean
  isSelected: boolean
  start: boolean
  text: number
  timestamp: number
  date: Date
  dayjs: Dayjs
  type: 'normal' | 'today' | 'week' | 'next-month' | 'prev-month'
}

四、官方资料中的各参数说明

Attributes

属性名	说明	类型	可选值	默认值
model-value / v-model	绑定值，如果它是数组，长度应该是 2	Date / number / string / Array	—	—
readonly	只读	boolean	—	false
disabled	禁用	boolean	—	false
size	输入框尺寸	string	large/default/small	default
editable	文本框可输入	boolean	—	true
clearable	是否显示清除按钮	boolean	—	true
placeholder	非范围选择时的占位内容	string	—	—
start-placeholder	范围选择时开始日期的占位内容	string	—	—
end-placeholder	范围选择时结束日期的占位内容	string	—	—
type	显示类型	string	year/month/ date/dates/ datetime/week/ datetimerange/ daterange/ monthrange	date
format	显示在输入框中的格式	string		YYYY-MM-DD
popper-class	DatePicker 下拉框的类名	string	—	—
popper-options	自定义 popper 选项，	object	—	—
range-separator	选择范围时的分隔符	string	—	'-'
default-value	可选，选择器打开时默认显示的时间	Date / [Date, Date]	—	—
default-time	范围选择时选中日期所使用的当日内具体时刻	Date / [Date, Date]	—	—
value-format	可选，绑定值的格式。 不指定则绑定值为 Date 对象	string		—
id	等价于原生 input id 属性	string / [string, string]	—	—
name	等价于原生 input name 属性	string	—	—
unlink-panels	在范围选择器里取消两个日期面板之间的联动	boolean	—	false
prefix-icon	自定义前缀图标	string | Component	—	Date
clear-icon	自定义清除图标	string | Component	—	CircleClose
validate-event	是否触发表单验证	boolean	—	true
disabled-date	一个用来判断该日期是否被禁用的函数，接受一个 Date 对象作为参数。 应该返回一个 Boolean 值。	function	—	—
shortcuts	设置快捷选项，需要传入数组对象	Array<{ text: string, value: Date | Function }>	—	—
cell-class-name	设置自定义类名	Function(Date)	—	—
teleported	是否将 date-picker 的下拉列表插入至 body 元素	boolean	true / false	true

Events

事件名	说明	回调参数
change	用户确认选定的值时触发	(val: typeof v-model)
blur	在组件 Input 失去焦点时触发	(e: FocusEvent)
focus	在组件 Input 获得焦点时触发	(e: FocusEvent)
calendar-change	如果用户没有选择日期，那默认展示当前日的月份。 你可以使用 default-value 来设置成其他的日期。	(val: [Date, Date])
panel-change	当日期面板改变时触发。	(date, mode, view)
visible-change	当 DatePicker 的下拉列表出现/消失时触发	(visibility: boolean)

Methods

方法名	说明	参数
focus	使 input 获取焦点	—
handleOpen	打开日期选择器弹窗	—
handleClose	关闭日期选择器弹窗	—

Slots

插槽名	说明
default	自定义内容
range-separator	自定义范围分割符内容

 五、总结

1	Element Plus 实例详解（一）__安装设置
2	Element Plus 实例详解（二）___Button 按钮
3	Element Plus 实例详解（三）___Date Picker 日期选择
4	Element Plus 实例详解（四）___Border 边框
5	Element Plus 实例详解（五）___Scrollbar 滚动条
6	Element Plus 实例详解（六）___Progress 进度条
7	Element Plus 实例详解（七）___Typography 排版
8	Element Plus 实例详解（八）___Radio 单选框
9	Element Plus 实例详解（九）___
10	Element Plus 实例详解（十）___
11	Element Plus 实例详解（十一）___
12	Element Plus 实例详解（十一）___

         推荐阅读：

31		Element Plus 应用实例详解系列
30	​​​​	Vue3安装配置、开发环境搭建(组件安装卸载)（图文详细）
29		SVG实例详解系列（一）(svg概述、位图和矢量图区别（图解）、SVG应用实例）
28		查看jdk安装路径，在windows上实现多个java jdk的共存解决办法，安装java19后终端乱码的解决
27		别具一格，原创唯美浪漫情人节表白专辑，(复制就可用)（html5,css3,svg)表白爱心代码(1)
26		2023年春节祝福第二弹——送你一只守护兔，让它温暖每一个你【html5 css3】画会动的小兔子，炫酷充电，字体特
25		2023春节祝福系列第一弹（上）（放飞祈福孔明灯，祝福大家身体健康）（附完整源代码及资源免费下载）
24		HTML+CSS+svg绘制精美彩色闪灯圣诞树，HTML+CSS+Js实时新年时间倒数倒计时(附源代码)
23		​草莓熊python绘图（春节版，圣诞倒数雪花版）附源代码
22		【程序人生】卡塔尔世界杯元素python海龟绘图（附源代码），世界杯主题前端特效5个（附源码）
21		python爱心源代码集锦（18款）
20	​​​​​​​	巴斯光年python turtle绘图__附源代码
19	​​​​​​​	Three.js实例详解___旋转的精灵女孩(附完整代码和资源)（一）
18	​​​​​​​	​草莓熊python turtle绘图代码（玫瑰花版）附源代码
17	​​​​​​​	立体多层玫瑰绘图源码__玫瑰花python 绘图源码集锦
16	​​​​​​​	皮卡丘python turtle海龟绘图（电力球版）附源代码
15	​​​​​​​	【CSDN云IDE】个人使用体验和建议（含超详细操作教程）（python、webGL方向)
14	​​​​​​​	草莓熊python turtle绘图（风车版）附源代码
13	​​​​​​​	用代码过中秋，python海龟月饼你要不要尝一口？
12	​​​​​​​	《 Python List 列表全实例详解系列（一）》__系列总目录、列表概念
11	​​​​​​​	用代码写出浪漫__合集（python、matplotlib、Matlab、java绘制爱心、玫瑰花、前端特效玫瑰、爱心）
10	​​​​​​​	Python函数方法实例详解全集(更新中...)
9	​​​​​​​	matplotlib 自带绘图样式效果展示速查（28种，全）
8	​​​​​​​	手机屏幕坏了____怎么把里面的资料导出（18种方法）
7	​​​​​​​	2023年3月TIOBE 指数头条：编程语言 Go 进入 TIOBE 指数前 10 名，多家权威机构____编程语言排行榜__薪酬状
6	​​​​​​​	Python中Print()函数的用法___实例详解(全，例多）
5	​​​​​​​	色彩颜色对照表（一）(16进制、RGB、CMYK、HSV、中英文名)
4	​​​​​​​	Node.js (v19.1.0npm 8.19.3) vue.js安装配置教程（超详细）
3	​​​​​​​	Tomcat 启动闪退问题解决集（八大类详细）
2	​​​​​​​	Tomcat端口配置（详细）
1	​​​​​​​	tomcat11、tomcat10 安装配置（Windows环境）（详细图文）