1、背景
在使用 EasyUI 各表单组件时,尤其是使用 ComboBox(下拉列表框)、DateBox(日期输入框)、DateTimeBox(日期时间输入框)这三个组件时,经常有这样的需求,下拉框或日期只允许选择、不允许手动输入,这时只要在组件选项中加入 editable:false 就可以实现,但有一个问题,就是:一旦选择了,没办法清空。经过研究,可以用一个变通的解决方案:给组件加上一个“清除”按钮,当有值是,显示按钮,点击按钮可清空值,当无值是,隐藏按钮。
2、函数定义
定义JS方法,为 EasyUI 中一些常用组件添加'清除'按钮及功能。共计6个:
添加‘清除'图标
* 该实现使用了 onChange 事件,如果用户需要该事件,可传入自定义函数,会自动回调 。
*/
function addClear4TextBox(theId,onChangeFun)
{
var theObj = $(theId);
//根据当前值,确定是否显示清除图标
var showIcon = function(){
var icon = theObj.textBox('getIcon',0);
if (theObj.textBox('getValue')){
icon.css('visibility','visible');
} else {
icon.css('visibility','hidden');
}
};
theObj.textBox({
//添加清除图标
icons:[{
iconCls:'icon-clear',handler: function(e){
theObj.textBox('clear');
}
}],//值改变时,根据值,确定是否显示清除图标
onChange:function(){
if(onChangeFun)
{
onChangeFun();
}
showIcon();
}
});
//根据目前值,确定是否显示清除图标
showIcon();
}
/*
* 为‘下拉列表框'添加‘清除'图标
* 该实现使用了 onChange 事件,如果用户需要该事件,可传入自定义函数,会自动回调 。
*/
function addClear4ComboBox(theId,onChangeFun)
{
var theObj = $(theId);
//根据当前值,确定是否显示清除图标
var showIcon = function(){
var icon = theObj.comboBox('getIcon',0);
if (theObj.comboBox('getValue')){
icon.css('visibility','hidden');
}
};
theObj.comboBox({
//添加清除图标
icons:[{
iconCls:'icon-clear',handler: function(e){
theObj.comboBox('clear');
}
}],//值改变时,根据值,确定是否显示清除图标
onChange:function(){
if(onChangeFun)
{
onChangeFun();
}
showIcon();
}
});
//初始化确认图标显示
showIcon();
}
/*
* 为‘数据表格下拉框'添加‘清除'图标
* 该实现使用了 onChange 事件,如果用户需要该事件,可传入自定义函数,会自动回调 。
*/
function addClear4Combogrid(theId,onChangeFun)
{
var theObj = $(theId);
//根据当前值,确定是否显示清除图标
var showIcon = function(){
var icon = theObj.combogrid('getIcon',0);
if (theObj.combogrid('getValue')){
icon.css('visibility','hidden');
}
};
theObj.combogrid({
//添加清除图标
icons:[{
iconCls:'icon-clear',handler: function(e){
theObj.combogrid('clear');
}
}],//值改变时,根据值,确定是否显示清除图标
onChange:function(){
if(onChangeFun)
{
onChangeFun();
}
showIcon();
}
});
//初始化确认图标显示
showIcon();
}
/*
* 为‘数值输入框'添加‘清除'图标
* 该实现使用了 onChange 事件,如果用户需要该事件,可传入自定义函数,会自动回调 。
*/
function addClear4NumberBox(theId,onChangeFun)
{
var theObj = $(theId);
//根据当前值,确定是否显示清除图标
var showIcon = function(){
var icon = theObj.numberBox('getIcon',0);
if (theObj.numberBox('getValue')){
icon.css('visibility','hidden');
}
};
theObj.numberBox({
//添加清除图标
icons:[{
iconCls:'icon-clear',handler: function(e){
theObj.numberBox('clear');
}
}],//值改变时,根据值,确定是否显示清除图标
onChange:function(){
if(onChangeFun)
{
onChangeFun();
}
showIcon();
}
});
//初始化确认图标显示
showIcon();
}
/*
* 为‘日期选择框'添加‘清除'图标
* 该实现使用了 onChange 事件,如果用户需要该事件,可传入自定义函数,会自动回调 。
*/
function addClear4DateBox(theId,onChangeFun)
{
var theObj = $(theId);
//根据当前值,确定是否显示清除图标
var showIcon = function(){
var icon = theObj.dateBox('getIcon',0);
if (theObj.dateBox('getValue')){
icon.css('visibility','hidden');
}
};
theObj.dateBox({
//添加清除图标
icons:[{
iconCls:'icon-clear',handler: function(e){
theObj.dateBox('clear');
}
}],//值改变时,根据值,确定是否显示清除图标
onChange:function(){
if(onChangeFun)
{
onChangeFun();
}
showIcon();
}
});
//初始化确认图标显示
showIcon();
}
/*
* 为‘日期时间选择框'添加‘清除'图标
* 该实现使用了 onChange 事件,如果用户需要该事件,可传入自定义函数,会自动回调 。
*/
function addClear4DatetimeBox(theId,onChangeFun)
{
var theObj = $(theId);
//根据当前值,确定是否显示清除图标
var showIcon = function(){
var icon = theObj.datetimeBox('getIcon',0);
if (theObj.datetimeBox('getValue')){
icon.css('visibility','hidden');
}
};
theObj.datetimeBox({
//添加清除图标
icons:[{
iconCls:'icon-clear',handler: function(e){
theObj.datetimeBox('clear');
}
}],//值改变时,根据值,确定是否显示清除图标
onChange:function(){
if(onChangeFun)
{
onChangeFun();
}
showIcon();
}
});
//初始化确认图标显示
showIcon();
}
3、使用
用法格式如下:
(1)addClear4TextBox("#name",nameChangeDo); //文本框,同时传入了回调函数
(2)addClear4ComboBox("#state\\.id");//下拉列表框
(3)addClear4Combogrid("#type\\.id");//数据表格下拉框
(4)addClear4NumberBox("#intNum2");//数值输入框
(5)addClear4DateBox("#theDate2");//日期选择框
(6)addClear4DatetimeBox("#theTime2");//日期选择框
函数的实现使用了 onChange 事件,如果需要使用该事件执行某些操作,可传入自定义函数,会自动回调 ,参见(1)。
//名称改变时执行的一些操作。(演示清除操作回调)
var nameChangeDo = function(){
//alert("改变了...");
}
$(function(){
addClear4TextBox("#code");
addClear4TextBox("#name",nameChangeDo);
addClear4ComboBox("#city");
addClear4ComboBox("#state\\.id");
addClear4Combogrid("#type\\.id");
addClear4ComboBox("#hobby");
addClear4NumberBox("#intNum2");
addClear4NumberBox("#doubleNum1");
addClear4NumberBox("#doubleNum2");
addClear4DateBox("#theDate2");
addClear4DatetimeBox("#theTime2");
addClear4TextBox("#remark");
});
4、效果展示
(1)有值时的情况(其中 类型 是数据列表下拉框)
(2)无值时的情况
以上所述是小编给大家介绍的jQuery EasyUI 组件加上“清除”功能实例详解。编程之家 jb51.cc 收集整理的教程希望能对你有所帮助,如果觉得编程之家不错,可分享给好友!感谢支持。