jquery-date
v2.0.1
Published
jquery-date 多格式、功能强大的移动端日期选择插件
Downloads
37
Readme
jdate(jquery-date)
此为jdate 2.0新版,完全参照jdate的下一代版本rolldate做了全新改版,查看旧版请点击返回旧版(1.4.3分支)
此版特色:
- 拥有和rolldate完全一样的功能;
- 体积更小,兼容性更强;
不足之处:
- 滑动较慢;
此版更适合滑动天数少的情况(比如限制只能滑动几天),或者兼容性要求高的情况,一般情况更推荐使用rolldate。并且jdate基本不怎么更新和维护,主要作为一个次要版本出现。
演示
jdate(下方直接扫码即可体验)
使用方式
特别注意:
jdate依赖jQuery,如果没有全局的$或jQuery(也要保证在jdate之前加载),必须先使用以下的代码:
Jdate.usejQuery($);
如:
import $ from 'jquery'
import Jdate from 'jdate'
Jdate.usejQuery($);
new Jdate({
el:'#date'
})
否则插件将报错,无法运行。
es6
import Jdate from 'jdate'
new Jdate({
el:'#date'
})
commonJS
var Jdate = require('jdate');
new Jdate({
el:'#date'
})
amd
require(['Jdate'],function(Jdate){
new Jdate({
el:'#date'
})
})
cmd
seajs.use('Jdate',function(undefined){
//插件没有遵循cmd规范,这里的Jdate是全局的
new Jdate({
el:'#date'
})
});
参数、方法说明
名称|必填|默认值|说明 ---|:-:|:-:|--- el|是|无|绑定插件的dom元素,插件内部使用document.querySelector,也可以直接传递dom元素对象,只支持单个 format|否|'YYYY-MM-DD'|日期格式,无限制。规则:年-YYYY 月-MM 日-DD 时-hh 分-mm 秒-ss 使用/、-、空格、:之一分隔,可随意组合 beginYear|否|2000|日期开始年份 endYear|否|2100|日期结束年份 value|否|无|日期初始化的默认值,列如'2018-03-18' lang|否|年、月、日...|配置插件语言,默认:title:'选择日期',cancel:'取消',confirm:'确认',year:'年',month:'月',day:'日',hour:'时',min:'分',sec:'秒' minStep|否|1|分钟按指定数分隔 init|否|null|插件触发前的回调函数,return false可阻止插件执行 moveEnd|否|null|插件滚动后的回调函数 confirm|否|null|确认按钮触发前的回调函数,return false可阻止插件执行,return其他值可修改日期,函数返回一个参数(选中的日期) cancel|否|null|插件取消时触发的回调函数 trigger|否|'tap'|默认使用tap解决移动端click事件300ms延迟,可选click替换tap。注意使用tap会阻止其他绑定的click事件的触发 show|否|无|主动触发插件,当trigger为tap时,主动触发插件应该使用此方法 hide|否|无|主动隐藏插件
//完整参数、方法示例
var jd = new Jdate({
el: '#date',
format: 'YYYY-MM-DD',
beginYear: 2000,
endYear: 2100,
minStep:1,
lang:{title:'自定义标题'},
trigger:'tap',
init: function() {
console.log('插件开始触发');
},
moveEnd: function() {
console.log('滚动结束');
},
confirm: function(date) {
console.log('确定按钮触发');
},
cancel: function() {
console.log('插件运行取消');
}
})
jd.show();
jd.hide();