FR.ajax

options

Object

必填，ajax參數。

url

String

必填，傳送請求的地址。

data

Object

傳送到伺服器的資料。GET 請求中将自動轉換為請求字串格式，附加在 URL 後。值必須是 Key/Value 格式，可以是字串。如 p1=pavalue&p2=p2value，或者是物件如 {p1:p1value,p2:p2value}。

type

String

請求方式 POST／GET ，預設為 GET。

dataType

String

預期伺服器傳回的資料型別。如果不指定，将自動根據 HTTP 包 MIME 資訊來智慧判斷。可用值有：

"xml"：傳回 XML 文檔。

"html"：傳回純文本 HTML 資訊；包含的 script 标簽會在插入 dom 時執行。

"script"：傳回純文本 JavaScript代碼。

"json"：傳回 JSON 資料。

"text"：傳回純文本字串。

"jsonp" : 跨域采用 jsonp 方式。

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);
	}
});

complete

Function

請求完成後回調函式(請求成功或失敗之後均呼叫)，function 中可以透過 this.xxx 來呼叫該 ajax 請求中的選項值。

complete: function(XMLHttpRequest, textStatus){  
//參數分别為 XMLHttpRequest 物件和一個描述成功請求是否成功的字串
 }

如下範例：

FR.ajax({
	url: "some.jsp",
	complete: function(XMLHttpRequest, textStatus) {
		alert(this.url);
	}
});

timeout

Number

設定請求超時時間（毫秒），此設定将覆蓋全局設定。

async

 Boolean

預設為 true，所有請求均為異步請求。如果需要傳送同步請求，請将此選項設定為 false。

注：同步請求将鎖住浏覽器，使用者其他操作必須等待請求完成才可以執行。