flatpickr功能强大的日期时间选择器插件

flatpickr日期时间选择器支持移动手机,提供多种内置的主题效果,并且提供对中文的支持。它的特点还有:

  • 使用SVG作为界面的图标。
  • 兼容jQuery。
  • 支持对各种日期格式的解析。
  • 轻量级,高性能,压缩后的版本仅6K大小。
  • 对手机原生日期格式的支持。

下图说明了使用jQuery UI、Bootstrap、packadate.js和flatpickr拉齐制作一个日期时间选择器时,所需要的文件尺寸大小:

下图是flatpickr日期时间选择器的各种主题效果:

配置参数

在配置参数中,所有的类型为stringboolean的参数都可以通过data-属性在HTML标签中进行设置。例如:data-min-datedata-default-datedata-default-date等。

参数 类型 默认值 描述
altFormat string "F j, Y" altInput的日期格式。
altInput Boolean false 是否使用某种用户友好的方式来显示日期时间。
altInputClass String "" 添加到input上的自定义class类。例如bootstrap用户可能需要添加一个form-control class。
allowInput boolean false 是否允许用户直接在输入框中输入日期。
clickOpens boolean true 是否在点击输入框时打开日期时间选择界面。如果你想通过手动.open()方法来打开,该选项设置为false
dateFormat string "Y-m-d" 设置日期显示格式。
defaultDate String/Date Object null 设置一个初始的日期。
disable array [] 被禁用的日期。
enableTime boolean false 是否启用时间选择。
enableSeconds boolean false 在时间选择器中是否可以选择秒。
noCalendar boolean false 是否隐藏日历。
hourIncrement integer 1 小时输入框的步长。
minuteIncrement integer 5 分钟输入框的步长。
inline boolean false 是否以内联的方式显示日历。
static boolean false 日期选择器位于包裹容器的位置。
wrap Boolean false 包裹元素。
maxDate String null 用户可以选择的最大日期。
minDate String null 用户可以选择的最小日期。
onChange function(dateObject, dateString) null 每次日期被选择的时候都触发该函数。
onOpen function(dateObject, dateString) null 每次日历被打开时都会触发该函数。
onClose function(dateObject, dateString) null 每次日历被关闭时都会触发该函数。
parseDate function false 接收一个日期字符串并返回一个日期对象。
shorthandCurrentMonth boolean false 以简写方式显示月份
weekNumbers boolean false 是否在日历中显示星期数。
time_24hr boolean false 是否以24小时格式来显示时间。
utc boolean false 如果为true,日期将会被解析、格式化和显示为UTC格式。
prevArrow string < 向前箭头图标。
nextArrow string > 向后箭头图标。
日期格式字符
字符 描述 示例
d 月份中的天数,如果不满2个数字的会前导0。 01 - 31
D 一个星期中某一天的简写文本表示 Mon - Sun
l(小写的L) 一个星期中某一天的文本表示 Sunday - Saturday
j 不带前导0的月份中的天数 1 - 31
J 带序号后缀,不带前导0的月份中的天数 1st, 2nd, to 31st
w 使用数字来代表星期中的某一天 0 (星期天) - 6 (星期六)
F 月份的完整文本表示 January - December
m 使用数字来表示月份,前导带0。 01 - 12
n 使用数字来表示月份,前导不带0。 1 - 12
M 月份的简写文本表示 Jan - Dec
U 时间戳 1413704993
y 两个数字代表的年 99 or 03
Y 4个数字代表的年 1999 or 2003
时间格式字符
字符 描述 示例
H 24小时制 00 to 23
h 12小时制 1 to 12
i 分钟 00 to 59
S 秒(不满2位数补0) 00 to 59
s 0 - 59
K AM/PM AM or PM

关于该日期时间选择器的本地化和其它一些使用方法,请参考演示页面中的DEMO。

flatpickr日期时间选择器插件的github地址为:https://github.com/chmln/flatpickr

使用方法:

在页面中引入flatpicker.css和flatpicker.js文件。

<link rel="stylesheet" type="text/css" href="/path/to/flatpickr.css">
<script src="/path/to/flatpickr.js"></script>

HTML示例:

<input id="myID">

初始化插件:

document.getElementsByClassName("myClass").flatpickr({..config});
document.getElementById("myID").flatpickr();    //  两种js初始化方法
$(".calendar").flatpickr(); // jQuery初始化方法

配置参数

在配置参数中,所有的类型为string或boolean的参数都可以通过data-属性在HTML标签中进行设置。例如:data-min-date、data-default-date、data-default-date等。

参数 类型 默认值 描述
altFormat string "F j, Y" altInput的日期格式。
altInput Boolean false 是否使用某种用户友好的方式来显示日期时间。
altInputClass String "" 添加到input上的自定义class类。例如bootstrap用户可能需要添加一个form-control class。
allowInput boolean false 是否允许用户直接在输入框中输入日期。
clickOpens boolean true 是否在点击输入框时打开日期时间选择界面。如果你想通过手动.open()方法来打开,该选项设置为false。
dateFormat string "Y-m-d" 设置日期显示格式。
defaultDate String/Date Object null 设置一个初始的日期。
disable array [] 被禁用的日期。
enableTime boolean false 是否启用时间选择。
enableSeconds boolean false 在时间选择器中是否可以选择秒。
noCalendar boolean false 是否隐藏日历。
hourIncrement integer 1 小时输入框的步长。
minuteIncrement integer 5 分钟输入框的步长。
inline boolean false 是否以内联的方式显示日历。
static boolean false 日期选择器位于包裹容器的位置。
wrap boolean false 包裹元素。
maxDate String null 用户可以选择的最大日期。
minDate String null 用户可以选择的最小日期。
onChange function(dateObject, dateString) null 每次日期被选择的时候都触发该函数。
onOpen function(dateObject, dateString) null 每次日历被打开时都会触发该函数。
onClose function(dateObject, dateString) null 每次日历被关闭时都会触发该函数。
parseDate function false 接收一个日期字符串并返回一个日期对象。
shorthandCurrentMonth boolean false 以简写方式显示月份
weekNumbers boolean false 是否在日历中显示星期数。
time_24hr boolean false 是否以24小时格式来显示时间。
utc boolean false 日期将会被解析、格式化和显示为UTC格式。
prevArrow string < 向前箭头图标。
nextArrow string > 向后箭头图标。

日期格式字符

字符 描述 示例
d 月份中的天数,如果不满2个数字的会前导0。 01 - 31
D 一个星期中某一天的简写文本表示 Mon - Sun
l(小写的L) 一个星期中某一天的文本表示 Sunday - Saturday
j 不带前导0的月份中的天数 1 - 31
J 带序号后缀,不带前导0的月份中的天数 1st, 2nd, to 31st
w 使用数字来代表星期中的某一天 0 (星期天) - 6 (星期六)
F 月份的完整文本表示 January - December
m 使用数字来表示月份,前导带0。 01 - 12
n 使用数字来表示月份,前导不带0。 1 - 12
M 月份的简写文本表示 Jan - Dec
U 时间戳 1413704993
y 两个数字代表的年 99 or 03
Y 4个数字代表的年 1999 or 2003

时间格式字符

字符 描述 示例
H 24小时制 00 to 23
h 12小时制 1 to 12
i 分钟 00 to 59
S 秒(不满2位数补0) 00 to 59
s 0 - 59
K AM/PM AM or PM

关于该日期时间选择器的本地化和其它一些使用方法,请参考演示页面中的DEMO。

文章来自:https://www.cnblogs.com/jiangxiaobo/p/6610203.html

原文地址:https://www.cnblogs.com/webqiand/p/11004910.html

时间: 2024-10-13 19:57:29

flatpickr功能强大的日期时间选择器插件的相关文章

日期时间选择器插件flatpickr

前言:在网页上需要输入时间的时候,我们可以用HTML5的inputl中的date类型.但是如下入所示,有些浏览器不支持.flatpickr这个小插件可以解决这个问题. 1.flatpickr日期时间选择器插件的github地址为:https://chmln.github.io/flatpickr/. 2.里面有很多例子,告诉我们呢怎么设置,不过太多很容易让人眼花.我这里做一个最简单的例子. 2.1引用人家的css和js //路径一定要写对 <link rel="stylesheet&quo

纯js可定制的跨浏览器日期时间选择器插件

Rome是一款纯js可定制的跨浏览器日期时间选择器插件.该日期时间选择器不依赖于jQuery,但它依赖于moment.js.可以通过CSS文件来自定义该日期时间选择器的外观样式. 如果你想了解moment的国际化的信息,可以查看这里.你还可以点击这里查看moment的使用方法. 在线演示:http://www.htmleaf.com/Demo/201503091491.html 下载地址:http://www.htmleaf.com/jQuery/Calendar-Date-Time-picke

插件介绍 :cropper是一款使用简单且功能强大的图片剪裁jQuery插件。

简要教程 cropper是一款使用简单且功能强大的图片剪裁jQuery插件.该图片剪裁插件支持图片放大缩小,支持鼠标滚轮操作,支持图片旋转,支持触摸屏设备,支持canvas,并且支持跨浏览器使用. cropper提供了大量的参数.方法和事件供图片的剪裁操作. 安装 可以通过Bower或NPM来安装该插件. 1 2 bower install cropper npm install cropper                使用方法 使用该图片剪裁插件首先要引入必要的js和css文件. 1 2

Android日期时间选择器实现以及自定义大小

本文主要讲两个内容:1.如何将DatePicker和TimePicker放在一个dialog里面:2.改变他们的宽度: 问题1:其实现思路就是自定义一个Dialog,然后往里面同时放入DatePicker和TimePicker,直接贴代码: date_time_picker.xml: <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://s

开发路程(11): 日期时间选择器datetimepicker

在做项目中,往往会遇到需要用户输入2014-07-19 09:55:53这样的格式的数据.就是典型的年月日时分秒这样的格式.这个时候,使用datetimepicker会比较简单. DateTimePicket jQuery 插件:使用此插件非强制性地将 datetimepicker. datepicker 或 timepicker 下拉列表添加到您的窗体.就是这样.很好看吧. 添加jquery.datetimepicker和datetimepicker.css到您的页面: 1 <link rel

基于Bootstrup的jQuery日期时间选择器

bootstrap-datetimepicker是一款基于Bootstrup 3的超实用jQuery日期时间选择器.通过该插件你可以非常容易的创建很酷的bootstrup样式的日期时间选择器. 你也可以通过修改css文件来自定义它的样式. 该jQuery日期时间选择器的最小外部依赖需求是: jQuery Moment.js Bootstrap.js(如果你不想使用完整的bootstrup,至少需要transition 和collapse) Bootstrap Datepicker script

日期时间选择器:datetimepicker

<!DOCTYPE HTML> <html> <head> <meta charset="utf-8"> <title>演示:日期时间选择器:datetimepicker</title> <link rel="stylesheet" type="text/css" href="css/main.css" /> <link rel=&quo

Android中实现日期时间选择器(DatePicker和TimePicker)

利用Android应用框架提供的DatePicker(日期选择器)和TimePicker(时间选择器),实现日期时间选择器. Dialog的Content布局文件(date_time_dialog.xml): <?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

JS日期时间选择器

本文介绍一种日期和时间选择器的用法.此选择器由jqueryUI实现,支持精确到毫秒的时间选择. 此选择器项目地址为http://trentrichardson.com/examples/timepicker/ Demo地址为:http://www.helloweba.com/demo/timepicker/ 下载地址:http://download.csdn.net/detail/yanwushu/7721933 效果图 另外关于js时间选择器还可以参考其他项目 http://www.bootc