此插件为jquery-date的全新版本,主要为了解决旧版参数设计不够合理、滑动效率不高、依赖jquery、没有可选的主题风格等问题,并增加了回调函数,使插件有更大的灵活性。
上一个版本为1.5.1, 新版本(从2.0.0开始)与此前版本的不同之处:
- 将滑动插件由iscroll替换为better-scroll,提升了兼容性;
- 改变了界面风格,操作更加方便;
- 取消了rolldate.css文件,只需引入js即可;
- 移除了主题风格、日期初始化的滑动时间设置;
注意2.0.0之前的版本将不再维护,如有需要请访问:旧版rolldate
rolldate(下方直接扫码即可体验)
import {Date as rolldate} from 'rolldate' new rolldate({ el:'#date' })
var rolldate = require('rolldate'); new rolldate.Date({ el:'#date' })
require(['rolldate'],function(rolldate){ new rolldate.Date({ el:'#date' }) })
seajs.use('rolldate',function(undefined){ //插件没有遵循cmd规范,这里的rolldate是全局的 new rolldate.Date({ el:'#date' }) });
| 名称 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| el | 是 | 无 | 绑定插件的dom元素,插件内部使用document.querySelector, 也可以直接传递dom元素对象,只支持单个 |
| format | 否 | 'YYYY-MM-DD' | 日期格式,支持YYYY-MM、YYYY-MM-DD、YYYY-MM-DD hh:mm、 YYYY、YYYY-MM-DD hh:mm:ss、MM、DD、hh:mm、hh:mm:ss、 YYYY-MM-DD hh、hh、mm、ss |
| beginYear | 否 | 2000 | 日期开始年份 |
| endYear | 否 | 2100 | 日期结束年份 |
| value | 否 | 无 | 日期初始化的默认值,列如'2018-03-18' |
| lang | 否 | 年、月、日... | 可配置插件语言,默认:title:'选择日期',cancel:'取消',confirm:'确认', year:'年',month:'月',day:'日',hour:'时',min:'分',sec:'秒' |
| minStep | 否 | 1 | 分钟按指定数分隔 |
| tapBefore | 否 | null | 插件触发前的回调函数,return false可阻止插件执行, 函数返回一个参数(绑定插件的dom元素) |
| moveEnd | 否 | null | 插件滚动后的回调函数,函数返回两个参数 (绑定插件的dom元素及better-scroll实例) |
| confirmBefore | 否 | null | 确认按钮触发前的回调函数,return false可阻止插件执行, return其他值可修改日期,函数返回两个参数(绑定插件的dom元素 及选中的日期) |
| confirmEnd | 否 | null | 插件运行结束后的回调函数,确认、取消都会执行,函数返回两个 参数(绑定插件的dom元素及选中的日期,取消时日期为undefined) |
//参数示例 new rolldate.Date({ el:'#date', format:'YYYY-MM-DD', beginYear:2000, endYear:2100, value:'2018-03-18', minStep:1, lang:{title:'自定义标题'}, tapBefore:function(el){ console.log('插件开始触发'); }, moveEnd:function(el,scroll){ console.log('滚动结束'); }, confirmBefore:function(el,date){ console.log('确定按钮触发'); }, confirmEnd:function(el,date){ console.log('插件运行结束'); } })