历史版本14 :FR.ajax 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. FR.ajax编辑

大家知道 JS 是前端代码，直接由浏览器来执行，不会与服务器进行交互。

通过 Ajax，用户就可使用 JavaScript的XMLHttpRequest 对象来直接与服务器进行通信。且在不重载页面的情况下与 Web 服务器交换数据。即所谓的异步请求。

2. 调用语法编辑

可以通过

FR.ajax(options)

在任何可以用 JavaScript 的地方进行调用。


2.1 参数

  参数
  类型
  说明
  options  Object  必填，Ajax 参数


options 以 JSON 格式提供，属性如下表：

  属性类型  
说明  
  url  String  必填，发送请求的地址
  type  String  请求方式 POST／GET，默认为 GET
  timeout  Number  设置请求超时时间（毫秒），此设置将覆盖全局设置。
  success  Function  请求成功后的回调函数
success: function(data, textStatus){  
 // data 为服务器返回的，并根据 dataType 参数进行处理后的数据。textStatus 为状态值 success
}
示例：FR.ajax({ url: "/webapps/webroot/a.html", success: function(data, textStatus){ alert(this.url); } });
  error  Function  请求失败时调用此函数
error: function(XMLHttpRequest, textStatus, errorThrown){ 
 //参数分别为 XMLHttpRequest 对象、错误信息、捕获的异常对象。通常 textStatus 和errorThrown 之中只有一个会包含信息
 }
示例：FR.ajax({ url: "some.jsp", error: function(XMLHttpRequest, textStatus, errorThrown){ alert(this.url); } });
 dataType  String  预期服务器返回的数据类型。如果不指定，将自动根据HTTP包MIME信息来智能判断。可用值有：
"xml"：返回 XML 文档
"html"：返回纯文本 HTML 信息；包含的 script 标签会在插入 dom 时执行。
"script"：返回纯文本 JavaScrip t代码。
"json"：返回 JSON 数据。
"text"：返回纯文本字符串。
"jsonp" : 跨域采用 jsonp 方式
  data Object 
  发送到服务器的数据。GET 请求中将自动转换为请求字符串格式，附加在 URL 后。
值必须是 Key/Value 格式，可以是字符串如"p1=pavalue&p2=p2value"，或者是对象如{p1:p1value,p2:p2value}
 complete Function  请求完成后回调函数(请求成功或失败之后均调用)
 complete: function(XMLHttpRequest, textStatus){  
//参数分别为 XMLHttpRequest 对象和一个描述成功请求是否成功的字符串
 }
示例：FR.ajax({ url: "some.jsp", complete: function(XMLHttpRequest, textStatus){ alert(this.url); } });
在 function 中可以通过 this.xxx 来调用该 Ajax 请求中的选项值。
  async  Boolean  默认为 true，所有请求均为异步请求。如果需要发送同步请求，请将此选项设置为 false。注：同步请求将锁住浏览器，用户其他操作必须等待请求完成才可以执行

3. 示例编辑

 示例：详细请查看 Ajax 跨域异步单点登录