文章分类 Classification
kendoUI系列教程之datetimepicker日期时间选择
稿件来源: 阳光企业网站管理系统 撰稿作者: 太阳光 发表日期: 2013-11-07 阅读次数: 19735 查看权限: 游客查看
kendoUI系列教程,kendoUI中文教程,kendoUI中文API说明文档之datetimepicker日期时间选择。
因datetimepicker是建立在datepicker基础上的多加了一个时间选择,使用例子:
<input id="datetimepicker" style="width:200px;" /> <script> $(document).ready(function () { $("#datetimepicker").kendoDateTimePicker({ value:new Date() }); }); </script>
Configuration配置项
1、动画 animation
类型:Object
说明:配置打开或者关闭下拉日期控件的特效。如果设值为false,打开或者关闭列表时将无动画。
<script> //关闭动画示例 $("#datetimepicker").kendoDateTimePicker({ animation: false }); //指定打开与关闭时的动画效果 $("#datetimepicker").kendoDateTimePicker({ animation: { close: { effects: "fadeOut zoom:out",//关闭时动画特效类型,多个特效用空格隔开。 duration: 300 //关闭时动画持续的时间,单位是毫秒。 }, open: { effects: "fadeIn zoom:in", duration: 300 } } }); </script>
2、aria-label值模板 ARIATemplate
类型:String
默认:"Current focused date is #=kendo.toString(data.current, 'G')#"
说明:配置输入框aria-label返回值。data-* 这些自定义数据属性允许您创建属性来与在您自己的网站上运行的脚本共享数据。它们还未被一般软件使用或采纳。您可以指定任意多个自定义数据属性。
<input id="datetimepicker" /> <script> $("#datetimepicker").kendoDatePicker({ ARIATemplate: "Date: #=kendo.toString(data.current, 'G')#" }); </script>
3、语言 culture
类型:String
默认:en-US
默认:en-US
说明:配置日历显示什么语言,kendoui配有几十种语言包,详细的参看js\cultures文件夹。
<div id="datetimepicker"></div> <script> $("#datetimepicker").kendoDatePicker({ culture: "zh-CN" //指定为中文 }); </script>
4、日期组 dates
类型:Array
说明:将用于在月视图模板下的日期集合。注意它不是自动显示在月视图下的,需要使用month.content来渲染。
说明:将用于在月视图模板下的日期集合。注意它不是自动显示在月视图下的,需要使用month.content来渲染。
<div id="datetimepicker"></div> <script> $("#datetimepicker").kendoDatePicker({ value: new Date(2000, 10, 1), dates: [ new Date(2000, 10, 10, 10, 0, 0), new Date(2000, 10, 10, 30, 0) ] //月视图模板可渲染这些日期 }); </script>
5、导航深度 depth
类型:String
说明:设置导航的深度级,可选以下值:
说明:设置导航的深度级,可选以下值:
- "month":显示本月所有日期
- "year":显示本年所有月份
- "decade":显示这个区间的十个年头
- "century":显示本世纪的每个十年区间
<div id="datetimepicker"></div> <script> $("#datetimepicker").kendoDateTimePicker({ depth: "year" }); </script>
6、脚部内容 footer
类型:String|Function
说明:设置日历脚部模板内容,设值为false时将隐藏脚部内容。
说明:设置日历脚部模板内容,设值为false时将隐藏脚部内容。
<div id="datetimepicker"></div> <script id="footer-template" type="text/x-kendo-template"> Today - #: kendo.toString(data, "d") # </script> <script> $("#datetimepicker").kendoDateTimePicker({ footer: kendo.template($("#footer-template").html()) }); </script> <!--或者--> <div id="datetimepicker"></div> <script> $("#datetimepicker").kendoDateTimePicker({ footer: "Today - #: kendo.toString(data, 'd') #" }); </script>
7、格式化 format
类型:String
默认:MM/dd/yyyy h:mm tt
默认:MM/dd/yyyy h:mm tt
说明:格式化日历使用value()方法返回的值。
<div id="datetimepicker"></div> <script> $("#datetimepicker").kendoDateTimePicker({ format: "yyyy/MM/dd hh:mm tt" }); </script>
8、最大日期 max
类型:Date
默认:2099, 11, 31
默认:2099, 11, 31
说明:指定日历可显示的最大日期。
9、最小日期 min
类型:Date
默认:1900, 0, 1
默认:1900, 0, 1
说明:指定日历可显示的最小日期。
<div id="datetimepicker"></div> <script> $("#datetimepicker").kendoDateTimePicker({ min: new Date(2011, 0, 1), max: new Date(2021, 0, 1) }); </script>
10、月视图 month
类型:Object
说明:月视图下每个格子的模板。
说明:月视图下每个格子的模板。
11、月视图内容 month.content
类型:String
说明:默认月视图下每个格子只显示对应的日期,而通过此属性可修改本月日期范围内每个格子的显示内容。
说明:默认月视图下每个格子只显示对应的日期,而通过此属性可修改本月日期范围内每个格子的显示内容。
<div id="datetimepicker"></div> <script id="cell-template" type="text/x-kendo-template"> <div class="#= data.value < 10 ? 'exhibition' : 'party' #"></div> #= data.value # </script> <script> $("#datetimepicker").kendoDateTimePicker({ month: { content: $("#cell-template").html() } }); </script>
12、月视图空格子内容 month.empty
类型:String
说明:指定不在max/min范围内的月视图下每个格子显示的内容,默认是为空。
说明:指定不在max/min范围内的月视图下每个格子显示的内容,默认是为空。
<div id="datetimepicker"></div> <script> $("#datetimepicker").kendoDateTimePicker({ month: { empty: '-' //指定无效日期里显示 "-" } }); </script>
13、默认初始视图 start
类型:String
默认:month
说明:指定初始时显示的视图。可选值有"month"、 "year"、 "decade"、 "century"四种视图。
默认:month
说明:指定初始时显示的视图。可选值有"month"、 "year"、 "decade"、 "century"四种视图。
<div id="datetimepicker"></div> <script> $("#datetimepicker").kendoDateTimePicker({ start: "year" }); </script>
14、默认值 value
类型:Date
默认:null
说明:指定初始时日历选中的日期与时间。
<input id="datetimepicker" /> <script> $("#datetimepicker").kendoDateTimePicker({ value: new Date(2011, 0, 1) }); </script>
15、格式解析 parseFormats
类型:Array
说明:指定一系列值用于解析value方法获取的值或者用户直接输入的值。
说明:指定一系列值用于解析value方法获取的值或者用户直接输入的值。
<input id="datetimepicker" /> <script> $("#datetimepicker").kendoDatePicker({ format: "yyyy/MM/dd hh:mm tt", parseFormats: ["MMMM yyyy","HH:mm"]//format的值也会自动加入此数组 }); </script>
16、分钟间隔interval
类型:Number
默认:30 (分钟)
说明:指定小时分钟下拉列表之间的分钟间隔。
默认:30 (分钟)
说明:指定小时分钟下拉列表之间的分钟间隔。
<input id="datetimepicker" /> <script> $("#dateTimePicker").kendoDateTimePicker({ interval: 15 //15分钟 }); </script>
17、时间格式化 timeFormat
类型:String
默认:h:mm tt
说明:指定小时分钟值的格式。
默认:h:mm tt
说明:指定小时分钟值的格式。
<input id="datetimepicker" /> <script> $("#datetimepicker").kendoDateTimePicker({ timeFormat: "HH:mm" //24小时制格式 }); </script>
以上配置可通过options获取:
<input id="datetimepicker" /> <script> $("#datetimepicker").kendoDatePicker(); var datetimepicker = $("#datetimepicker").data("kendoDatePicker"); var options = datetimepicker.options; <script>
Methods 方法
<div id="datetimepicker"></div> <script> $("#datetimepicker").kendoDateTimePicker(); var datetimepicker = $("#datetimepicker").data("kendoDateTimePicker"); datetimepicker.enable(false); //设置是否可用。 datetimepicker.readonly(true); //设置是否只读。 var max = datetimepicker.max();//获取日历最大日期 datetimepicker.max(new Date(2100, 0, 1));//设置日历最大日期 var min = datetimepicker.min();//获取日历最小日期 datetimepicker.min(new Date(1999, 0, 1));//设置日历最小日期 var value = datetimepicker.value(); //获取日期时间。 datetimepicker.value(new Date()); //设置日期时间。 datetimepicker.destroy();//销毁日历,删除日历所有事件与方法 datetimepicker.open("date"); //打开日期弹窗。 datetimepicker.open("time"); //打开时间弹窗。 datetimepicker.close("date"); //关闭日期弹窗。 datetimepicker.close("time"); //关闭时间弹窗。 datetimepicker.toggle("time"); //切换时间弹窗开关。 </script>
Events 事件
<div id="datetimepicker"></div> <script> $("#datetimepicker").kendoDateTimePicker({ open: function(e) { if(e.view == "time"){ e.preventDefault(); //禁止打开 } }, close: function(e) { if(e.view == "date"){ e.preventDefault(); //禁止关闭 } }, change: function() { var value = this.value();//改变值时触发 } }); //这些事件都可使用bind绑定。 </script>
支持RTL显示。
Keyboard Navigation 快捷键
关闭了日期选择控件时
序号 | 快捷键 | 作用 |
---|---|---|
1 | alt + w | 获取焦点。需要设置html5的accesskey属性 |
2 | enter | 触发change事件 |
3 | esc | 关闭日期控件弹窗 |
4 | alt + down arrow | 打开日期控件弹窗 |
5 | alt + up arrow | 关闭日期控件弹窗 |
打开了日期选择控件时
序号 | 快捷键 | 作用 |
---|---|---|
1 | enter | 如果在月视图下将选择高亮日期,其他视图将向下翻视图。 |
2 | left arrow | 高亮前一天 |
3 | right arrow | 高亮后一天 |
4 | up arrow | 高亮同列上一个日期 |
5 | down arrow | 高亮同列下一个日期 |
6 | ctrl + left arrow | 向左切换视图 |
7 | ctrl + right arrow | 向右切换视图 |
8 | ctrl + up arrow | 向上切换视图 |
9 | ctrl + down arrow | 向下切换视图 |
10 | home | 选中本视图的第一格 |
11 | end | 选中本视图的最后一格 |
打开了时间选择控件时
序号 | 快捷键 | 作用 |
---|---|---|
1 | up + arrow | 选择上一个可选时间 |
2 | down + arrow | 选择下一个可选时间 |
在线测试:http://demos.kendoui.com/web/datetimepicker/index.html
关键词: kendoui,html5,datetimepicker 编辑时间: 2013-11-07 16:43:03
7
高兴5
支持4
搞笑0
不解1
谎言0
枪稿0
震惊2
无奈0
无聊0
反对0
愤怒
95.24%(40)
4.76%(2)
- 暂无评论
文章图片 article Pictrue
网友评论