workdesktop的ajax被打包成了自己的服务。它的内核为axios,所以使用页面需要有axios引入。如果是使用include.js导入助手,则已经包含了该引用。
该变量已经挂在至window上,直接在页面使用 `window.$wd` 即可获取对象实例。注意,vue实例里this会被覆盖掉,
通过执行 `window.$wd.v()` 可在输出控制台版本号。
window.$wd.$http为ajax服务对象,它有以下常用方法:
| 方法名 | 说明 | 参数 |
| --- | --- |--- |
| get | 发起一个get请求 | url:请求的url;configs:配置对象,详情查看configs内容;callbacks:回调方法对象,详情查看callbacks内容; |
| post | 发起一个post请求 | url:请求的url;configs:配置对象,详情查看configs内容;callbacks:回调方法对象,详情查看callbacks内容; |
| patch | 发起一个patch请求 | url:请求的url;configs:配置对象,详情查看configs内容;callbacks:回调方法对象,详情查看callbacks内容; |
| delete | 发起一个delete请求 | configs:配置对象,详情查看configs内容;callbacks:回调方法对象,详情查看callbacks内容; |
| head | 发起一个head请求 | configs:配置对象,详情查看configs内容;callbacks:回调方法对象,详情查看callbacks内容; |
| getUri | 发起一个uri请求 | configs:配置对象,详情查看configs内容;callbacks:回调方法对象,详情查看callbacks内容; |
| create | 创建一个请求,需要指定配置的method属性 | configs:配置对象,详情查看configs内容;callbacks:回调方法对象,详情查看callbacks内容; |
> 如果你希望使用promise方式,可以使用wd.$http.$axios对象来获取axios进行调用。
## Configs配置
| 配置 | 说明 | 参数说明 |
| --- | --- | --- |
| successTip | 辅助配置,操作成功后(返回code>=0)消息提示类型 | 包含类型:none,message,notify,alert |
| failTip | 辅助配置,操作失败后(返回code<0)消息提示类型 | 包含类型:none,message,notify,alert |
| loading | 辅助配置,是否启用loading状态 | 开启状态下,ajax请求完成前会有loading加载内容 |
| loadingConfig | 辅助配置,loading状态配置 | target:loading在哪个node上显示;body:是否插入至body;fullscreen:是否全屏;lock:是否锁定滚动;text:显示文本;spinner:加载图标类名;background:遮罩背景色;customClass:loading的自定义类名; |
| 其他 | 支持所有axios配置参数 | |
> workdesktop提供默认配置,配置文件位置:/js/workdesktop/config.js
## callbacks配置
| 配置 | 说明 | 参数说明 |
| --- | --- | --- |
| success | 请求结果成功,code=0 | responseData:响应数据 |
| fail | 请求结果失败,fail | responseData:响应数据 |
| complete | ajax请求完成,无论结果是成功或者失败或者异常,它始终会执行 | 当执行成功时返回responseData,中途出现异常时返回exception |
| exception | ajax请求过程中发生错误 | exception:异常实例 |
> 注意:如果在success、fail或者complete里面发生的异常也会引发exception方法,并且继续抛出该异常。
- 序言
- 安装
- 组件查询
- buttons
- WdApiButton
- WdDrawerButton
- WdRefreshButton
- WdRouteButton
- WdConfirmButton
- datagrid
- WdDatagrid
- WdGridDeleteButton
- WdGridEnableButton
- editgrid
- WdEditgrid
- WdEditgridCell
- element
- WdCard
- WdCollapse
- WdDrawerIframe
- WdIframe
- WdLabel
- WdSplitLabel
- WdDetail
- WdToolBar
- WdRepeater
- WdApiManager
- form
- WdDataForm
- WdSelect
- WdRadioList
- WdCheckboxList
- WdUploadImage
- search
- WdSearchCheckbox
- WdSearchDatepick
- WdSearchForm
- WdSearchInput
- WdSearchRadio
- WdSearchSelect
- tree
- WdTree
- 内置服务
- ajax服务
- 消息服务
- 框架方法
- tab操作
- 其他
- demo说明