输入自动提示搜索提示功能(使用说明:sugggestion.txt)

readme:
本文件记录了suggestion.js文件的功能使用说明:
/*
 * 功能:该js文件中的代码实现了[输入自动搜索提示]功能,如百度、google搜索框中输入一些字符会以下拉列表形式给出一些提示,提高了用户体验;
 * 使用技术:JQuery+Ajax
 * 
 * 一、如何使用该功能?
 * 1.使用该功能是需引入以下文件:
 * 1)<link type="text/css" rel="stylesheet" href="<%=baseURL %>/appName/css/common/suggestion.css"/>
 * 2)<script type="text/javascript" src="<%=baseURL %>/appName/js/common/jquery-1.9.1.js"></script>
 * 3)<script type="text/javascript" src="<%=baseURL %>/appName/js/common/suggestion.js"></script>
 * 2.需要在文件中添加标签如下所示:
 * <input type="text" id="keywords_input" autocomplete="off" searchURL="<%=baseURL%>/appName/sug/getSug.spring">
 * <div id="sug_layer_div"></div>
 * 说明:
 * 1).在使用该功能的页面引入该文件,同时该功能使用了jQuery技术,依赖于jQuery文件,要在引入suggestion.js之前引入jQuery文件;
 * 2).这里假定你需要使用该功能的文本输入框为:<input type="text">;
 * 3).为该input标签指定id为'keywords_input',如<input type="text" id="keywords_input">;
 * 4).为该input标签指定autocomplete为'off',如<input type="text" autocomplete="off">;
 * 5).为该input标签添加自定义属性searchURL,该属性的值为需要调用控制器方法的URL,如需要调用sugController控制器的getSug方法来返回搜索提示数据,则
 * <input type="text" searchURL="<%=baseURL%>/appName/sug/getSug.spring">
 * (这里使用Spring MVC框架);
 * 6).在input标签下面加一个id为'sug_layer_div'的DIV标签,如<div id="sug_layer_div"></div>
 * 
 * 3.请求-响应数据格式说明:(json数据格式)
 * 1)前端示例:
$.ajax({
  type:"GET", //AJAX提交方式为GET提交
  dataType:"json",
  url:$("#keywords_input").attr("searchURL"),//处理页面的URL地址
  data:{ //要传递的参数
"keywords_input":escape($("#keywords_input").val())
},
  success:function(data) {
  var result = data.sugList;;//前端需要的数据
......
  }
});
 * 2)后台示例:
@Controller
@RequestMapping("/el/sug")
@SuppressWarnings({"rawtypes","unchecked"})
public class SugController extends ElBaseController{
  @RequestMapping("getSug")
public void getSuggestion (HttpServletRequest request ,HttpServletResponse response)throws JSONException {
log.info("<------获取搜索提示数据---SugController.getSuggestion--------->");
JSONObject json = new JSONObject();
String errMsg = "";
List sugList = new LinkedList<String>();
try {
String keyword = request.getParameter("keywords_input");//前端传来的数据(输入框中的数据)
List sugList = SugService.getSuggestionList(keywords_input);

}catch (Exception e) {
errMsg = "获取数据时出现异常,"+e.getMessage();
json.put("codeid","FAILURE");
}
json.put("sugList",sugList);//要响应前端的数据
ajaxResultText(response,json.toString());
}
 * 
 * 二、如何了解该功能的实现?
 * 阅读本文件的代码,你应了解以下一些基础知识:
 * 1.keyUp,keyDown等事件中一些键码对:
 * 按键 键码 | 按键 键码| 按键键码
 * 0 48 9 57 0(数字键盘)96
 * A 65 Z 90 9(数字键盘)105
 * BackSpace 8 Up-Arrow   38  Dw-Arrow40
 * 
 * 2.JavaScript escape()函数
 * escape()函数可对字符串进行编码,这样就可以在所有的计算机上读取该字符串
 * 该方法不会对 ASCII字母和数字进行编码,也不会对下面这些 ASCII标点符号进行编码: * @ - _ + . / 。
 * 其他所有的字符都会被转义序列替换。如:escape("?!=()#%&") -->  %3F%21%3D%28%29%23%25%26
 * 
 * 3.autocomplete属性规定输入字段是否应该启用自动完成功能。 自动完成允许浏览器预测对字段的输入。
 * 当用户在字段开始键入时,浏览器基于之前键入过的值,应该显示出在字段中填写的选项。把该autocomplete属性值设为'off',
 * 就是要关闭浏览器自带的输入提示功能
 * 注释:autocomplete属性适用于<form>,以及下面的 
 * <input>类型:text,search,url,telephone,email,password,datepickers,range以及 color。
 * 
 * Author:sunfei(孙飞) Date:2013.08.21
 * 
 */

你可能感兴趣的:(输入自动搜索提示功能)