快速开始
var http = $.http;
http.get('/server', function() {
// 请求成功且返回status === true时的回调
});
初始化
默认会在发送请求时自动初始化, 但是也可以使用http.init(options)手动初始化。
初始化时的配置参数说明:
options.style: 初始化样式
options.html: 初始化模板
options.title: 弹框提示的标题内容, 可省
options.buttons: 弹框提示时的按钮文字, 可省(buttons: {submit, cancel})
options.codeKey: 返回内容的code部分的键名(默认为code)
options.statusKey: 返回内容的status部分的键名(默认为status)
options.codeMaps: Object, 对应code的错误提示内容
options.messages: Object, 对应400/500系列状态码的错误提示内容
当服务端返回的状态码为400/500等时, 弹框提示内容为options.messages中的定义; 当服务端返回的状态码为200系列时, 弹框提示内容为options.codeMaps中的定义, 如果未定义, 则显示res.message, 如果还没有, 则提示默认错误内容
发送ajax请求
除了$.ajax本身的配置项之外, 其余增加的配置如下:
options.uuid: 请求的唯一标记, 添加该标记则在该次请求结束之前无法重复提交该请求
options.loading: 是否显示全屏loading, 默认为true
options.title: 弹框提示的标题内容, 可省
options.buttons: 弹框提示时的按钮文字, 可省(buttons: {submit, cancel})
options.alert: 是否弹框, 默认为true, 如果为'both', 则成功时也会弹框
options.ignore: 是否在status为false时执行成功的回调, 默认为true不执行
options.confirm: 在操作前弹出确认框(confirm: {title, message})
方法名称
http.init(options)
全局初始化配置。
http.ajax(options)
发送ajax请求。
http.get(url, [fn,] options)
发送get请求。 当第二个参数为函数时, 则为请求成功时的回调, 也可以省略第二个参数, 此时第二个参数即为请求配置项参数。
http.post(url, data, [fn,] options)
发送post请求。参数说明同get。
http.put(url, data, [fn,] options)
发送put请求。参数说明同get。
http.delete(url, [fn,] options)
发送delete请求。参数说明同get。
辅助方法
http.info(message, title)
提示信息，标题title可省略。
http.warn(message, title)
提示信息，标题title可省略。
http.error(message, title)
提示信息，标题title可省略。
http.success(message, title)
提示信息，标题title可省略。
http.confirm(message, title, callback, fallback, buttons)
确认信息，其中以下字段可省略: title, fallback, buttons。
上下文context
在beforeSend，complete，success和error回调函数中，如果没有在options中指定上下文，则this默认指向$.http对象。
$('#sendPost').on('click', function () {
$.http.post('/success?status=1', {
a: 100
}, {
success: function(res){
this.info('操作成功');
}
})
});
