<script type="text/javascript" src="./jquery.min.js"></script> <script type="text/javascript" src="./jquery.keyboard.js"></script> <script type="text/javascript"> // 指定元素 var kb1 = $('#keyboard').keyboard(option); // 全局元素 var kb2 = $.keyboard(option); </script>
字段 | 类型 | 必须 | 默认值 | 说明 |
---|---|---|---|---|
elem | object | N | null | 位置元素,使用$(xx).keyborad(o)时,默认元素为xx/HTML;否则为指定elem/HTML. |
lineCn | int | N | 3 | 键盘按钮一行显示几个,1-10之间 |
shade | boolean/string | N | true | 是否显示阴影,传入RGB可自定义阴影颜色和透明度。 |
shadeClose | boolean | N | true | 是否点击阴影关闭键盘,在shade开启时有效。 |
fixed | boolean | N | true | 是否绝对定位。 |
animate | boolean | N | true | 显示隐藏是否使用动画。 |
heads | array | N | [] | 不填或false,表示不显示头部栏;请查阅 《头部栏》 参数。 |
keys | array | Y | ['1', '2', '3', '4', '5', '6', '7', '8', '9', '', '0', ''] | 必填,键盘显示内容;请查阅 《键盘栏》 参数。 |
click | method | N |
键盘被点击的回调,包含3个参数:type,index,elem.
type类型:0键盘栏,1头部栏
index下标:被点击是第几个,是数组下标
elem元素:被点击的按钮元素对象
|
头部栏分为左中右3大块,故为长度3的数组,如不需要某个位置的头部栏时,填空即可。如:['<button>取消</button>','', '完成'],还也可以加图标,但一般情况文字也能实现的,如:[ '取消', '设置', '完成' ]
// 使用文字: heads: [ '取消', '设置', '完成' ], // 使用HTML: heads: ['<button>取消</button>','设置', '<i class="layui-icon layui-icon-ok"></i>'], // 只要取消: heads: [ '取消'], // 不要取消和设置: heads: [ '', '', '完成' ],
键盘栏设置比较灵活,可以简单的[1,2,3,4,5,6],也可以横跨、纵跨几行几列。
// 使用文字: keys: ['1', '2', '3', '4', '5', '6', '7', '8', '9', 'X', '0', '退格', '上一个', '下一个', '确定'], // 使用HTML: keys: ['1', '2', '3', '4', '5', '6', '<button>清空</button>','<i class="layui-icon layui-icon-ok"></i>'], // 复杂使用(横跨、纵跨): keys : [ '1', '2', '3', '4', '5', '6', '7', '8', '9', 'X', '0', { text : '退格', rowspan : 2, colspan : 1, }, '上一页', '下一页', { text : '保存', colspan : 3, } ],以下是对复杂情况使用场景中,字段的解释:
字段 | 类型 | 必须 | 默认值 | 说明 |
---|---|---|---|---|
text | string | Y | 文本/HTML | |
colspan | int | N | 1 | 横跨数 |
rowspan | int | N | 1 | 纵跨数 |
在使用keyborad初始化后会返回一个对象,其中包含了几个方法:
显示键盘,可用于input得到焦点事件中,触发显示键盘。
隐藏键盘,可用于点击键盘中的确认按钮后,触发隐藏键盘。
kb.get(2, 0); 即:kb.get(数组序号,目标栏0键盘栏1头部栏)
获取指定序号的元素,比如获取确定键。
获取/设置指定序号元素的文本值。
获取:kb.text(2); 或 kb.text(0, 1) ;设置:kb.text(10, '简单') 或 kb.text(2, '关闭', 1)
禁用/启用指定序号元素的文本值。
同获取,但暂未开放!
<script type="text/javascript" src="./jquery.min.js"></script> <script type="text/javascript" src="./jquery.keyboard.js"></script> <script type="text/javascript"> var kb = $.keyboard({ elem : 'HTML', lineCn : 3, shade : true, shadeClose : true, fixed : true, animate : true, heads: [ '取消', '设置', '完成' ], keys : [ '1', '2', '3', '4', '5', '6', '7', '8', '9', 'X', '0', { text : '退格', rowspan : 2, colspan : 1, }, '上一页', '下一页', { text : '保存', colspan : 3, } ], click : function(type, index, text) { console.log('被点击了:', type, index, text); } }); kb.show(); kb.hide(); </script>
(演示中,3秒后隐藏,3秒后显示)