jQuery Date Range Picker是一款允许用户选择一个日期时间范围的jQuery日期选择器插件。整个日期选择器插件使用CSS来渲染样式,可以非常容易的使用CSS来定制皮肤。而且浏览器兼容性非常好,支持多种时间格式。
查看演示 下载源码
准备
使用该日期选择器插件需要 jQuery 1.3.2+和Moment 2.2.0+的支持。
1 2 3 |
|
HTML结构
在需要放置日期选择器的地方添加以下html结构,就是一个输入框。
1 |
|
调用插件
调用jQuery Date Range Picker插件非常简单,和其他常见的jQuery插件一样:
1 |
|
配置参数
该日期选择器的默认配置参数如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 |
|
format (String):Moment的日期格式。点击这里查看Moment文档。
separator (String):日期字符串之间的分隔符。
language (String):预定义的语言是"en"和"cn"。你可以使用这个参数自定义语言。也可以设置为"auto"来让浏览器自己检测语言。
startOfWeek (String):"sunday" 或 "monday"。
getValue (Function):当从DOM元素中获取日期范围时会调用该函数,函数的上下文被设置为datepicker DOM。
setValue (Function):当向DOM元素中写入日期范围时调用该函数。
startDate (String or false):定义用户允许的最早日期,格式和format相同。
endDate (String or false):定义用户允许的最后日期,格式和format相同。
minDays (Number) :该参数定义日期范围的最小天数,如果设置为0,表示不限制最小天数。
maxDays (Number):该参数定义日期范围的最大天数,如果设置为0,表示不限制最大天数。
showShortcuts (Boolean) :先生或隐藏shortcuts区域。
time (Object):如果允许该参数就会添加时间的范围选择。
shortcuts (Object):定义快捷键按钮。
customShortcuts (Array):定义自定义快捷键按钮。
inline (Boolean):使用inline模式渲染该日期选择器,而不是overlay模式。如果设置为true,则要一起设置container参数。
container (String, css selector || DOM Object) :要进行渲染的日期选择器DOM元素。
alwaysOpen (Boolean):如果使用inline模式,你可能希望在页面加载时就渲染日期选择器。该参数设置为true时会隐藏"close"按钮。
singleDate (Boolean):设置为true可以选择单个的日期。
batchMode (false / 'week' / 'month'):自动批处理模式。
事件
当该日期选择器在DOM中选择某个日期范围时会触发三个事件。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
|
API
在你调用$(dom).dateRangePicker()之后:
1 2 3 4 5 6 |
|
项目地址:https://github.com/longbill/jquery-date-range-picker
相关推荐:
Atas ialah kandungan terperinci jQuery日期范围选择器分析. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!