useServer
useServer 是一款高效灵活的 Api 对接工具. 可通过 Network 查看效果
基础使用
基本使用 useServer, 通过 run 调用 list 接口数据
data: [
"default 能够协助设置初始数据"
]
自动调用
实现初始化时默认调用一次接口, 通过设置 autoRun 实现初始化自动加载
data: []
动态查询条件
动态查询条件分三种方案均能完成
1. 双向绑定查询条件
2. 传入响应式对象
3. 通过run传入params
格式化 response
通过 beforeSetData 可在 useServer 对 data 赋值前修改数据格式
data: []
依赖变更刷新 api
deps
收集需要侦听的响应式变量, 当其中有某一依赖变更 会调用run
, depsCondition: true
时会将data
与urlParams
同时放入deps
{
"num": 0
}
data: [
"default 能够协助设置初始数据"
]
防抖/节流 api
debounceTime
、throttleTime
键入时间(ms)会默认开启防抖/节流
, 开启后会作用在任何调用方式中
debounce
data: [
"default 能够协助设置初始数据"
]
正确/错误响应提示配置
successMessage
、errorMessage
在请求成功或失败时给出相应的提示
successMessage
data: [
"default 能够协助设置初始数据"
]
useServer Api
userServer Api
属性 | 说明 | 类型 | 可选择 | 默认值 |
---|---|---|---|---|
api | 接口配置名称 | api 具体 key | - | - |
data | params | Ref<{}> | {} | - | - |
default | 默认值 | any | - | - |
autoRun | 初始化 useServer 时执行 | boolean | false、true | false |
urlParams | url 拼接参数 | string | Ref<string> | - | - |
headers | request header | - | - | - |
successMessage | request 成功时提示语 | - | - | - |
errorMessage | request 失败时提示语 | - | - | - |
onError | 失败回调 | (err)=> void | - | - |
onSuccess | 成功回调 | (data: Data, response: Response<Data>)=> void | - | - |
beforeSetData | data 改变之前回调 | (data: Data, response: Response<Data>)=> Result | - | - |
beforeRequest | data 发起请求之前 | (requestCondition: RequestCondition)=> RequestCondition | - | - |