为JQueryEasyUI表单组件加上“清除”功能

转载自：https://www.cnblogs.com/rulian/p/6690326.html

1、背景

    在使用 EasyUI 各表单组件时，尤其是使用 ComboBox（下拉列表框）、DateBox（日期输入框）、DateTimeBox（日期时间输入框）这三个组件时，经常有这样的需求，下拉框或日期只允许选择、不允许手动输入，这时只要在组件选项中加入 editable:false 就可以实现，但有一个问题，就是：一旦选择了，没办法清空。经过研究，可以用一个变通的解决方案：给组件加上一个“清除”按钮，当有值是，显示按钮，点击按钮可清空值，当无值是，隐藏按钮。

2、函数定义

定义JS方法，为 EasyUI 中一些常用组件添加&＃39;清除&＃39;按钮及功能。共计6个： 

/** 为‘文本框’列表添加‘清除’图标* 该实现使用了 onChange 事件，如果用户需要该事件，可传入自定义函数，会自动回调 。*/
function addClear4TextBox(theId,onChangeFun)
{var theObj = $(theId);//根据当前值，确定是否显示清除图标var showIcon = function(){ var icon = theObj.textbox(&＃39;getIcon&＃39;,0);if (theObj.textbox(&＃39;getValue&＃39;)){icon.css(&＃39;visibility&＃39;,&＃39;visible&＃39;);} else {icon.css(&＃39;visibility&＃39;,&＃39;hidden&＃39;);}};theObj.textbox({//添加清除图标icons:[{iconCls:&＃39;icon-clear&＃39;,handler: function(e){theObj.textbox(&＃39;clear&＃39;);}}],//值改变时，根据值，确定是否显示清除图标onChange:function(){if(onChangeFun){onChangeFun();}showIcon();}}); //根据目前值，确定是否显示清除图标showIcon();
}/** 为‘下拉列表框’添加‘清除’图标* 该实现使用了 onChange 事件，如果用户需要该事件，可传入自定义函数，会自动回调 。*/
function addClear4Combobox(theId,onChangeFun)
{var theObj = $(theId);//根据当前值，确定是否显示清除图标var showIcon = function(){ var icon = theObj.combobox(&＃39;getIcon&＃39;,0);if (theObj.combobox(&＃39;getValue&＃39;)){icon.css(&＃39;visibility&＃39;,&＃39;visible&＃39;);} else {icon.css(&＃39;visibility&＃39;,&＃39;hidden&＃39;);}};theObj.combobox({//添加清除图标icons:[{iconCls:&＃39;icon-clear&＃39;,handler: function(e){theObj.combobox(&＃39;clear&＃39;);}}],//值改变时，根据值，确定是否显示清除图标onChange:function(){if(onChangeFun){onChangeFun();}showIcon();}}); //初始化确认图标显示showIcon();
}/** 为‘数据表格下拉框’添加‘清除’图标* 该实现使用了 onChange 事件，如果用户需要该事件，可传入自定义函数，会自动回调 。*/
function addClear4Combogrid(theId,onChangeFun)
{var theObj = $(theId);//根据当前值，确定是否显示清除图标var showIcon = function(){ var icon = theObj.combogrid(&＃39;getIcon&＃39;,0);if (theObj.combogrid(&＃39;getValue&＃39;)){icon.css(&＃39;visibility&＃39;,&＃39;visible&＃39;);} else {icon.css(&＃39;visibility&＃39;,&＃39;hidden&＃39;);}};theObj.combogrid({//添加清除图标icons:[{iconCls:&＃39;icon-clear&＃39;,handler: function(e){theObj.combogrid(&＃39;clear&＃39;);}}],//值改变时，根据值，确定是否显示清除图标onChange:function(){if(onChangeFun){onChangeFun();}showIcon();}}); //初始化确认图标显示showIcon();
}/** 为‘数值输入框’添加‘清除’图标* 该实现使用了 onChange 事件，如果用户需要该事件，可传入自定义函数，会自动回调 。*/
function addClear4Numberbox(theId,onChangeFun)
{var theObj = $(theId);//根据当前值，确定是否显示清除图标var showIcon = function(){ var icon = theObj.numberbox(&＃39;getIcon&＃39;,0);if (theObj.numberbox(&＃39;getValue&＃39;)){icon.css(&＃39;visibility&＃39;,&＃39;visible&＃39;);} else {icon.css(&＃39;visibility&＃39;,&＃39;hidden&＃39;);}};theObj.numberbox({//添加清除图标icons:[{iconCls:&＃39;icon-clear&＃39;,handler: function(e){theObj.numberbox(&＃39;clear&＃39;);}}],//值改变时，根据值，确定是否显示清除图标onChange:function(){if(onChangeFun){onChangeFun();}showIcon();}}); //初始化确认图标显示showIcon();
}/** 为‘日期选择框’添加‘清除’图标* 该实现使用了 onChange 事件，如果用户需要该事件，可传入自定义函数，会自动回调 。*/
function addClear4Datebox(theId,onChangeFun)
{var theObj = $(theId);//根据当前值，确定是否显示清除图标var showIcon = function(){ var icon = theObj.datebox(&＃39;getIcon&＃39;,0);if (theObj.datebox(&＃39;getValue&＃39;)){icon.css(&＃39;visibility&＃39;,&＃39;visible&＃39;);} else {icon.css(&＃39;visibility&＃39;,&＃39;hidden&＃39;);}};theObj.datebox({//添加清除图标icons:[{iconCls:&＃39;icon-clear&＃39;,handler: function(e){theObj.datebox(&＃39;clear&＃39;);}}],//值改变时，根据值，确定是否显示清除图标onChange:function(){if(onChangeFun){onChangeFun();}showIcon();}}); //初始化确认图标显示showIcon();
}/** 为‘日期时间选择框’添加‘清除’图标* 该实现使用了 onChange 事件，如果用户需要该事件，可传入自定义函数，会自动回调 。*/
function addClear4Datetimebox(theId,onChangeFun)
{var theObj = $(theId);//根据当前值，确定是否显示清除图标var showIcon = function(){ var icon = theObj.datetimebox(&＃39;getIcon&＃39;,0);if (theObj.datetimebox(&＃39;getValue&＃39;)){icon.css(&＃39;visibility&＃39;,&＃39;visible&＃39;);} else {icon.css(&＃39;visibility&＃39;,&＃39;hidden&＃39;);}};theObj.datetimebox({//添加清除图标icons:[{iconCls:&＃39;icon-clear&＃39;,handler: function(e){theObj.datetimebox(&＃39;clear&＃39;);}}],//值改变时，根据值，确定是否显示清除图标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）。

4、效果展示

（1）有值时的情况（其中 类型 是数据列表下拉框）

（2）无值时的情况

5、进一步扩展

增加自动添加“清除”功能的函数，省去每个组件手动添加的麻烦。

（1）自动添加函数定义

//自动填加清除功能 （组件需要增加 addClear属性 ）
function autoAddClear()
{var arr = $("input[addClear]");for(var i=0;i}

（2）使用时，各组件上添加 addClear 属性。

（3）使用自动添加 

$(function(){autoAddClear(); //为各组件自动填加‘清除’功能（组件需要增加 addClear属性 ）addClear4TextBox("#name",nameChangeDo); //对于需要使用OnChange事件的组件，单独手动填加

转载自：https://www.cnblogs.com/rulian/p/6690326.html