bui.ajax Class
数据请求, $.ajax 跟 app.ajax 有的参数, bui.ajax 都有. 可以全局配置所有请求的默认参数: bui.config.ajax = { headers: {} }
预览地址: demo
Constructor
bui.ajax
-
option
Parameters:
-
option
Object-
url
String[请求的地址]
-
data
Object传输的数据为json对象 {}
-
[baseUrl]
String optional请求的域名,可以单独配置,1.5.4新增
-
[method]
String optional传输的方法 GET | POST
-
[headers]
Object optional通过header传输的参数 {}
-
[async]
Boolean optionaltrue 是异步 | false 是同步
-
[transformRequest]
Function optional1.5.4新增,可以在数据请求前,对data做处理,需要返回
-
[transformResponse]
Function optional1.5.4新增,可以在数据请求成功后,对data做处理,再进行返回
-
[dataType]
String optional默认 json | jsonp | script | xml | html | text
-
[contentType] GET默认 'text/html;charset=UTF-8'(中文会被转码,可以传"",由$.ajax处理 ) | POST默认: 'application/x-www-form-urlencoded'(表单,接口跨域需要设置这个) | 'multipart/form-data'(表单里有file文件) | 'application/json'(后端要用@requestbody接收) 前端传过去的参数要用 JSON.stringify 转换下]
String optional -
[cache] 1.5.6 默认 true | false]
String optional -
[timeout]
Number optional超出这个时间则认为请求失败
-
[needJsonString]
Boolean optional1.4.6新增,默认 false|true. true时会尝试把数据转换为string. 这个主要配合list控件的特殊请求使用,正常都是一个对象, 如果为true,后台一般以@requestbody 接收,postman的body 是raw 的形式
-
[needNative]
Boolean optional1.5.1新增,默认 false 使用webajax | true 使用原生, 大部分打包以后支持跨域,如果不支持,再手动切换成原生, 前提是你的bui.js是支持原生版
-
[proxy]
String optional1.5.5新增, 内部修改接口为相对路径,值为:代理的二级目录,例如: 接口地址 http://easybui.com/api/getUser?id=123 配置 proxy: "/api" 这样接口请求就变成 api/getUser?id=123, 结合工程的 app.json 使用
-
Example:
// 例子1. 简单示例:
bui.ajax({
url: "",
data: {}
}).then(function(res){
console.log(res)
},function(res,status){
console.log(status);
// status = "timeout" || "error" || "abort", "parsererror"
})
Methods
open
-
[option] []
-
[option.url] [ 文件路径,一般是通过getFile得到的路径]
-
[option.onSuccess] [成功的回调]
-
[option.onFail] [失败的回调]
本地程序打开文件
Parameters:
-
[option] []
Object optional -
[option.url] [ 文件路径,一般是通过getFile得到的路径]
String optional -
[option.onSuccess] [成功的回调]
Function optional -
[option.onFail] [失败的回调]
Function optional
Example:
uiFile.open({
url: "file://",
onSuccess: function(url){
// 文件的地址
console.log(url)
}
})
widget
-
[name] [ 依赖控件名 fileselect]
获取依赖的控件
Parameters:
-
[name] [ 依赖控件名 fileselect]
String optional
Example:
//获取依赖控件
var uiFileSelect = uiFile.widget("fileselect");
//使用uifileselect的方法
uiFileSelect.add({
onSuccess: function(data){
console.log(data);
}
});