BUI

其它版本:

API for BUI 1.5.4

Show:

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 optional

      [true 是异步 | false 是同步 ]

    • [transformRequest] Function optional

      [1.5.4新增,可以在数据请求前,对data做处理,需要返回]

    • [transformResponse] Function optional

      [1.5.4新增,可以在数据请求成功后,对data做处理,再进行返回]

    • [dataType] String optional

      [默认 json | jsonp | script | xml | html | text]

    • [contentType] String optional

      [get默认 'text/html;charset=UTF-8' | post默认: 'application/x-www-form-urlencoded'(表单,接口跨域需要设置这个) | 'multipart/form-data'(表单里有file文件) | 'application/json'(后端要用@requestbody接收) 前端传过去的参数要用 JSON.stringify 转换下 ]'

    • [timeout] Number optional

      [超出这个时间则认为请求失败]

    • [needJsonString] Boolean optional

      [1.4.6新增,默认 false|true. true时会尝试把数据转换为string. 这个主要配合list控件的特殊请求使用,正常都是一个对象, 如果为true,后台一般以@requestbody 接收,postman的body 是raw 的形式 ]

    • [needNative] Boolean optional

      [1.5.1新增,默认 false 使用webajax | true 使用原生, 大部分打包以后支持跨域,如果不支持,再手动切换成原生, 前提是你的bui.js是支持原生版 ]

Example:

    // 例子1. 简单示例:
        bui.ajax({
            url: "",
            data: {}
        }).then(function(res){
            console.log(res)
        },function(res,status){
            console.log(status);
          // status = "timeout" || "error" || "abort", "parsererror"
        })

   // 例子2. 1.5.4 新增, 通过全局配置修改所有请求, 请求的地址是: http://www.easybui.com/demo/json/shop.json 
       // 全局配置
       bui.config.ajax = {
           baseUrl: "http://www.easybui.com/"
           headers: {}
       }

       bui.ajax({
           url: "demo/json/shop.json",
           data: {}
       }).then(function(res){
           console.log(res)
       },function(res,status){
           console.log(status);
           // status = "timeout" || "error" || "abort", "parsererror"
       })

Item Index