这里有新鲜出炉的 jQuery 示例,程序狗速度看过来!
jQuery 是一个兼容多浏览器的 javascript 框架,核心理念是 write less,do more(写得更少, 做得更多)。jQuery 在 2006 年 1 月由美国人 John Resig 在纽约的 barcamp 发布,吸引了来自世界各地的众多 JavaScript 高手加入,由 Dave Methvin 率领团队进行开发。
这篇文章主要介绍了 jQuery autoComplete 插件两种使用方式及动态改变参数值的方法, 结合实例形式分析了 jQuery 自动匹配插件 autoComplete 的使用技巧与动态改变参数传入值的实现方法, 需要的朋友可以参考下
本文实例讲述了 jQuery autoComplete 插件两种使用方式及动态改变参数值的方法。分享给大家供大家参考,具体如下:
一、一次加载、多次使用:
前端 JS 代码:
- /*客户名称自动匹配*/
- function customerAutoComplete() {
- $.ajax({
- type: "GET",
- url: encodeURI("/approvalajax/salesOrderApproval_findCustomerList"),
- dataType: "json",
- success: function(data, textStatus) {
- if (data != null && data.customerList != null) {
- $("#customerFullName").autocomplete(data.customerList, {
- /**加自定义表头**/
- tableHead: "<div><span style='width:40%' class='col-1'>客户编码</span> <span style='width:58%' class='col-2'>客户名称</span></div>",
- minChars: 0,
- width: 310,
- matchContains: "true",
- autoFill: false,
- extraParams: {
- ledger: $("#ledger").val()
- },
- formatItem: function(row, i, max) {
- return "<span style='width:40%' class='col-1'>" + row.cusCode + "</span> " + "<span style='width:58%' class='col-2'>" + row.cusName + "</span>";
- },
- formatMatch: function(row, i, max) {
- return row.cusCode + row.cusName;
- },
- formatResult: function(row) {
- return row.cusName;
- }
- }).result(function(e, data, value, sec) {
- /**加选中后的回调函数**/
- clearCustomerInfo();
- $("#customerShortName").val(data.cusAbbName);
- $("#customerFullName").val(data.cusName);
- $("#customerCode").val(data.cusCode);
- /*根据选择的客户、账套加载 对应产品线、收付款协议、账期*/
- setPLAndPCAndCP(data.cusCode);
- /*加载存货编码*/
- setInventoryAutoComplete(data.cusCode);
- }).bind("unmatch",
- function() {
- clearCustomerInfo();
- });
- }
- }
- });
- }
后台 JAVA 代码:
- /**
- * 异步请求结果.
- */
- private Map < String,
- Object > ajaxResultMap;
- /**
- * @Description 根据账套异步加载客户列表
- * @throws Exception
- * @return String
- */
- public String findCustomerList() throws Exception {
- ajaxResultMap = new HashMap < String,
- Object > ();
- response.setContentType("text/html;charset=UTF-8");
- response.setCharacterEncoding("UTF-8");
- List < ErpCustomer > list = erpDataService.findCustomerList(ledger);
- ajaxResultMap.put("customerList", list);
- return SUCCESS;
- }
配置文件相关代码:
- <package name="approval-ajax" extends="json-default" namespace="/approvalajax">
- <!-- 销售订单 审批相关 -->
- <action name="salesOrderApproval_*" method="{1}" class="xx.xxx.xxAction">
- <result type="json">
- <param name="root">
- ajaxResultMap
- </param>
- <param name="contentType">
- text/html
- </param>
- </result>
- </action>
- </package>
二、根据输入内容动态加载:
前端 JS 代码:
- /*客户名称自动匹配*/
- function customerAutoComplete() {
- $("#customerFullName").autocomplete(encodeURI("/approvalajax/salesOrderApproval_findCustomerList"), {
- /**加自定义表头**/
- tableHead: "<div><span style='width:40%' class='col-1'>客户编码</span> <span style='width:58%' class='col-2'>客户名称</span></div>",
- minChars: 0,
- width: 310,
- matchContains: "true",
- autoFill: false,
- extraParams: {
- ledger: $("#ledger").val()
- },
- dataType: 'json',
- parse: function(data) {
- var rows = [];
- if (data == null || data.customerList == null) {
- return rows;
- }
- for (var i = 0; i < data.customerList.length; i++) {
- rows[rows.length] = {
- data: data.customerList[i],
- //下拉框显示数据格式
- value: data.customerList[i].cusName,
- //选定后实际数据格式
- result: data.customerList[i].cusName //选定后输入框显示数据格式
- };
- }
- return rows;
- },
- formatItem: function(row, i, max) {
- return "<span style='width:40%' class='col-1'>" + row.cusCode + "</span> " + "<span style='width:58%' class='col-2'>" + row.cusName + "</span>";
- },
- formatMatch: function(row, i, max) {
- return row.cusCode + row.cusName;
- },
- formatResult: function(row) {
- return row.cusName;
- }
- }).result(function(e, data, value, sec) {
- /**加选中后的回调函数**/
- clearCustomerInfo();
- $("#customerShortName").val(data.cusAbbName);
- $("#customerFullName").val(data.cusName);
- $("#customerCode").val(data.cusCode);
- $("#licensecode").val(data.licensecode);
- /*根据选择的客户、账套加载 对应产品线、收付款协议、账期*/
- setPLAndPCAndCP(data.cusCode);
- /*存货编码*/
- addInventoryAutoComplete($("#detailListTbody").find("input[tdTag=inventoryCode]"));
- }).bind("unmatch",
- function() {
- clearCustomerInfo();
- });
- }
后台 JAVA 代码:
- /**
- * @Fields q 自动填充辅助字符
- */
- private String q;
- /**
- * 异步请求结果.
- */
- private Map < String,
- Object > ajaxResultMap;
- /**
- * @Description 根据账套异步加载客户列表
- * @throws Exception
- * @return String
- */
- public String findCustomerList() throws Exception {
- ajaxResultMap = new HashMap < String,
- Object > ();
- response.setContentType("text/html;charset=UTF-8");
- response.setCharacterEncoding("UTF-8");
- List < ErpCustomer > list = erpDataService.findTop5CustomerList(ledger, q);
- ajaxResultMap.put("customerList", list);
- return SUCCESS;
- }
说明:在使用动态加载时,请求的 URL 中插件会自动追加 q 参数,用于传输输入的参数。
注:使用 Jquery 中的 autoComplete 插件实现自动匹配功能时,直接使用它来解析 json 对象时,会出现一个错误提示,因为它默认使用 "/n" 拆分行、"|" 拆分字段。如果需要使用它来解析 json 对象,则需要自己实现其 parse 方法。
参数说明:
* minChars (Number): 在触发 autoComplete 前用户至少需要输入的字符数. Default: 1,如果设为 0,在输入框内双击或者删除输入框内内容时显示列表 * width (Number): 指定下拉框的宽度. Default: input 元素的宽度 * max (Number): autoComplete 下拉显示项目的个数. Default: 10 * delay (Number): 击键后激活 autoComplete 的延迟时间(单位毫秒).Default: 远程为 400 本地 10 * autoFill (Boolean): 要不要在用户选择时自动将用户当前鼠标所在的值填入到 input 框. Default: false * mustMatch (Booolean): 如果设置为 true,autoComplete 只会允许匹配的结果出现在输入框, 所有当用户输入的是非法字符时将会得不到下拉框. Default: false * matchContains (Boolean): 决定比较时是否要在字符串内部查看匹配, 如 ba 是否与 foo bar 中的 ba 匹配. 使用缓存时比较重要. 不要和 autofill 混用. Default: false * selectFirst (Boolean): 如果设置成 true, 在用户键入 tab 或 return 键时 autoComplete 下拉列表的第一个值将被自动选择, 尽管它没被手工选中(用键盘或鼠标). 当然如果用户选中某个项目, 那么就用用户选中的值. Default: true * cacheLength (Number): 缓存的长度. 即对从数据库中取到的结果集要缓存多少条记录. 设成 1 为不缓存. Default: 10 * matchSubset (Boolean): autoComplete 可不可以使用对服务器查询的缓存, 如果缓存对 foo 的查询结果, 那么如果用户输入 foo 就不需要再进行检索了, 直接使用缓存. 通常是打开这个选项以减轻服务器的负担以提高性能. 只会在缓存长度大于 1 时有效. Default: true * matchCase (Boolean): 比较是否开启大小写敏感开关. 使用缓存时比较重要. 如果你理解上一个选项, 这个也就不难理解, 就好比 foot 要不要到 FOO 的缓存中去找. Default: false * multiple (Boolean): 是否允许输入多个值即多次使用 autoComplete 以输入多个值. Default: false * multipleSeparator (String): 如果是多选时, 用来分开各个选择的字符. Default: "," * scroll (Boolean): 当结果集大于默认高度时是否使用卷轴显示 Default: true * scrollHeight (Number): 自动完成提示的卷轴高度用像素大小表示 Default: 180 * formatItem (Function): 为每个要显示的项目使用高级标签. 即对结果中的每一行都会调用这个函数, 返回值将用 LI 元素包含显示在下拉列表中. Autocompleter 会提供三个参数(row, i, max): 返回的结果数组, 当前处理的行数(即第几个项目, 是从 1 开始的自然数), 当前结果数组元素的个数即项目的个数. Default: none, 表示不指定自定义的处理函数, 这样下拉列表中的每一行只包含一个值. * formatResult (Function): 和 formatItem 类似, 但可以将将要输入到 input 文本框内的值进行格式化. 同样有三个参数, 和 formatItem 一样. Default: none, 表示要么是只有数据, 要么是使用 formatItem 提供的值. * formatMatch (Function): 对每一行数据使用此函数格式化需要查询的数据格式. 返回值是给内部搜索算法使用的. 参数值 row * extraParams (Object): 为后台 (一般是服务端的脚本) 提供更多的参数. 和通常的作法一样是使用一个键值对对象. 如果传过去的值是{bar:4}, 将会被 autocompleter 解析成 my_autocomplete_backend.php?q=foo&bar=4 (假设当前用户输入了 foo). Default: {} * result (handler) Returns: jQuery 此事件会在用户选中某一项后触发,参数为: event: 事件对象. event.type 为 result. data: 选中的数据行. formatted:formatResult 函数返回的值 例如:
- $("#singleBirdRemote").result(function(event, data, formatted) {
- //如选择后给其他控件赋值,触发别的事件等等
- });
注:另一种方式可动态改变参数传入值。
我们知道这个插件有一个 extraParams 的参数,因为 jquery.autoComplete 只支持 q 和 limit 两个参数,假如有这样的情况,我们需要向服务器提交更多参数怎么办呢,幸好,作者为我们提供一个扩展参数,就是 extraParams。extraParams 好是好,可是不幸的是,它是一个死的参数,有时候,我们需要提交一个活的参数到服务器。举例说明,比如说我们有一个公司名称的自动完成功能,但我们同时需要向服务器提供一个城市的参数,正常的情况下没有问题。但当城市的名称是由用户选择的时候,就有问题了,也就说,这个城市的名称是根据用户选择而实时变化的,这个时候,现有的 jquery.autoComplete 就无能为力了。
这个时候我们就要考虑修改修改一下 jquery.autoComplete 了,我们先看一下代码,代码有一个 onChange 事件,这是一个解发事件,我们可以在这里添加一个回调函数来解决问题。首先我们要为 options 中添加一个参数叫 onBegin,大致就在 400 行左右吧,有一行这样的代码:
- $.Autocompleter.defaults =
我们在后面添加一段
- onBegin: null,
然后我们找到 onChange 事件,约在 226 行,代码如下:
- function onChange(crap, skipPrevCheck)
在函数时里面添加如下代码:
if (options.onBegin) {var op = options.onBegin(options); if (op) {$.extend(options, op); } }
这段代码被修改过后看起来就像这样:
- function onChange(crap, skipPrevCheck) {
- //2010-01-27 ,添加onBegin函数,以便在启动onChange的时候,可以重新设置options
- if (options.onBegin) {
- var op = options.onBegin(options);
- if (op) {
- $.extend(options, op);
- }
- }
- //end
- if (lastKeyPressCode == KEY.DEL) {
- select.hide();
- return;
- }
- var currentValue = $input.val();
- if (!skipPrevCheck && currentValue == previousValue) return;
- previousValue = currentValue;
- currentValue = lastWord(currentValue);
- if (currentValue.length >= options.minChars) {
- $input.addClass(options.loadingClass);
- if (!options.matchCase) currentValue = currentValue.toLowerCase();
- request(currentValue, receiveData, hideResultsNow);
- } else {
- stopLoading();
- select.hide();
- }
- };
再来看调用:
- /*客户名称自动匹配*/
- function customerAutoComplete() {
- $("#customerFullName").autocomplete(encodeURI("/approvalajax/salesOrderApproval_findCustomerList"), {
- /**加自定义表头**/
- tableHead: "<div><span style='width:40%' class='col-1'>客户编码</span> <span style='width:58%' class='col-2'>客户名称</span></div>",
- minChars: 0,
- width: 310,
- multiple: false,
- mustMatch: false,
- matchContains: false,
- matchSubset: false,
- autoFill: false,
- onBegin: function(options) { //修改--用于动态改变ledger的值
- options.extraParams.ledger = $("#ledger").val();
- return options;
- },
- //extraParams: {ledger:$("#ledger").val()},
- dataType: 'json',
- parse: function(data) {
- var rows = [];
- if (data == null || data.customerList == null) {
- return rows;
- }
- for (var i = 0; i < data.customerList.length; i++) {
- rows[rows.length] = {
- data: data.customerList[i],
- //下拉框显示数据格式
- value: data.customerList[i].cusName,
- //选定后实际数据格式
- result: data.customerList[i].cusName //选定后输入框显示数据格式
- };
- }
- return rows;
- },
- formatItem: function(row, i, max) {
- return "<span style='width:40%' class='col-1'>" + row.cusCode + "</span> " + "<span style='width:58%' class='col-2'>" + row.cusName + "</span>";
- },
- formatMatch: function(row, i, max) {
- return row.cusCode + row.cusName;
- },
- formatResult: function(row) {
- return row.cusName;
- }
- }).result(function(e, data, value, sec) {
- /**加选中后的回调函数**/
- clearCustomerInfo();
- $("#customerShortName").val(data.cusAbbName);
- $("#customerFullName").val(data.cusName);
- $("#customerCode").val(data.cusCode);
- $("#licensecode").val(data.licensecode);
- /*根据选择的客户、账套加载 对应产品线、收付款协议、账期*/
- setPLAndPCAndCP(data.cusCode);
- }).bind("unmatch",
- function() {
- clearCustomerInfo();
- });
- }
其实做的只有三步:
1. 在 options 中添加一个 onBegin 的参数 2. 在 onChange 中判断 onBegin 是否有赋值,如果有,则调用这个函数,返回将返回值合并到 options 中去 3. 调用的时候,在 onBegin 函数中添加一些业务逻辑,并可以重新设置 options
就这样,我们不仅可以达到动态去添加 extraParams 参数,而且还可以动态地修改其它 options 参数,这个 onBegin 在用户改变输入框的值就会触发。
希望本文所述对大家 jQuery 程序设计有所帮助。
来源: http://www.phperz.com/article/17/0428/330963.html