下拉框F7

简介

下拉框F7

使用方法

1. 静态框架使用方法仅EAS7.5版本
<wafctrl:promptAutocomplete id="id" name="name" />
2. JS动态创建EAS8.0+
var dom = waf.createDOM("promptAutocomplete", options);
waf.appendDOM(parent, dom);
waf.initComponent("promptAutocomplete", options, dom);
3. 通用DOM创建EAS8.0+
<input id="id" name="number" type="text" class="enter2tab ui-promptAutocomplete form" ctrlrole="promptAutocomplete" aria-disabled="false" style="" tabindex="0">
<!--DOM创建好之后，使用js初始化控件-->
waf.initComponent("promptAutocomplete", options, dom);
4. 方法&事件使用EAS7.5+
//调用方法
waf("#id").wafPromptAutocomplete('method', parameter...);
//eg:获取和设置值
waf("#id").wafPromptAutocomplete("getValue");
waf("#id").wafPromptAutocomplete("setValue");
//eg:更改事件
waf("#id").wafPromptAutocomplete("option","onchange",fn);

DOM结构

<input id="id" name="number" type="text" class="enter2tab ui-promptAutocomplete form" ctrlrole="promptAutocomplete" aria-disabled="false" style="" tabindex="0">

属性说明

arraySource Array 缺省值: null)(能在运行期改变 EAS7.5+

定义类型为数组的数据选项来源;

autoChoose Boolean 缺省值: true)(能在运行期改变 EAS7.5+

设置在自动补全只匹配到一条记录时, 不打开辅助面板, 直接自动选择这条记录;

autoFocus Boolean 缺省值: false)(能在运行期改变 EAS7.5+

定义选项列表的第一个选项是否自动获得焦点;

delay Integer 缺省值: 300)(能在运行期改变 EAS7.5+

定义自动补全延迟执行时间，以毫秒为单位;

autoCompleteItem String 缺省值: name)(能在运行期改变 EAS7.5+

指定autoComplete查询的项目.;

cu Boolean 缺省值: true)(能在运行期改变 EAS7.5+

指定是否CU过滤;

filteritem String 缺省值: null)(能在运行期改变 EAS7.5+

设置查询的过滤条件;

formatter function 缺省值: null)(能在运行期改变 EAS7.5+

定义选项列表的格式化方法,参数：item - 描绘的数据对象;options - 自动完成F7的属性;ul - 用于显示的ul元素;

functionSource function 缺省值: null)(能在运行期改变 EAS7.5+

定义类型为回调函数的数据选项来源;

maxHeight Integer 缺省值: null)(能在运行期改变 EAS7.5+

定义选项列表的最大高度;

minlength Integer 缺省值: 1)(能在运行期改变 EAS7.5+

定义需要输入的最少字符数，默认值为1。 对于较少的本地数据可以设置为0。当建议选项过多造成单个字符可匹配数据量过大时，minlength的值可以适当设置稍大一点;

isMulti Boolean 缺省值: false)(能在运行期改变 EAS7.5+

设置是否能够多选;;

minlength Integer 缺省值: 1)(能在运行期改变 EAS7.5+

定义需要输入的最少字符数，默认值为1。对于较少的本地数据可以设置为0。当建议选项过多造成单个字符可匹配数据量过大时，minlength的值可以适当设置稍大一点.;

query String 缺省值: null)(能在运行期改变 EAS7.5+

指定Query对象.;

sidx String 缺省值: null)(能在运行期改变 EAS7.5+

指定排序项目;;

sord String 缺省值:null)(能在运行期改变 EAS7.5+

指定排序类型;

style String 缺省值: null)(能在运行期改变 EAS7.5+

定义下拉框F7控件的样式;

tagClass String 缺省值: null)(能在运行期改变 EAS7.5+

定义下拉框F7控件样式类，可以添加一个或多个;

urlSource String 缺省值: {ContextPath}/component/promptAutoComplete.do?method=getData”)(能在运行期改变 EAS7.5+

定义类型为字符串的数据选项来源，该字符串为可获得json对象的url地址;

方法说明

事件说明

onselect 参数: (event,data) EAS7.5+

事件说明：
当选择面板中的值的时候,触发onselect事件

参数说明：
  - event-onselect的eventdata-类型为对象,包括data(选择的数据),selected(选择状态).   

返回值说明：

onshow 参数: (event,panel) EAS7.5+

事件说明：
显示时触发事件,可以修改panel以改变显示结果

参数说明：
  - event-onshow的event​panel-显示的面板对象.   

返回值说明：

beforeProcessing 参数: (event,data) EAS7.5+

事件说明：
当ajax返回后,下拉框F7处理前,触发事件,用于调整查询结果

参数说明：
  - event-beforeProcessing的event​data-ajax返回的对象.   

返回值说明：

serializePromptData 参数: (data) EAS7.5+

事件说明：
当ajax发起前,更改传递到后台的数据

参数说明：
  - ​data-当前的查询条件.   

返回值说明：

样例集合