注意:本章节介绍的是基础封装,所有内置封装均继承自基础封装并进行了扩展!
```
<template>
...
</template>
<script>
import JBoot from 'jboot-env'; //引入框架
export default JBoot.base({
data (){}
});
</script>
<style lang="scss">
...
</style>
```
**内置属性:**
| 名称 | 类型 | 默认值 | 必须主动声明| 描述|
| --- | --- | --- | --- |--- |
|moduleName |string| 无 |是|查询列表数据时,要调用的api名称,依赖于options.wrap配置项|
|queryCondition|object|{}|否|查询列表数据时,传递给接口的查询条件,推荐绑定属性到form上面|
|querying|boolean|false|否|true为正在查询中,false为查询完毕|
|initQuery|boolean|true(form时,默认为false,只有showXXX、toXXX的方法调用才会触发查询。如为true则直接触发查询。)|否|是否页面初始化完毕后,立即执行查询。|
|__jumpParam|object|{}|否|**3.1.3694起新增!!!** 如果页面通过调用__pageJump方法跳转而来,则传入的参数会自动解密赋值到此页面,list中的toXXX方法底层也是通过__pageJump来实现跳转的。|
**内置计算属性:**
| 名称 | 类型 | 默认值 | 必须主动声明| 描述|
| --- | --- | --- | --- |--- |
|dynamicQueryMethod|string| 返回queryMethod属性。 |否|使用该计算属性,可根据依赖值动态的改变请求调用的方法。|
**内置方法:**(编写顺序按照执行顺序排列)
| 名称 | 参数| 返回值|描述|
| --- | --- | --- | --- |
|encoderJumpParam(params) | params:需要加密的跳转参数|返回object对象,可直接赋值给route的query参数。|**注意:3.1.3709起新增!!!** 进行跳转参数的加密处理,目标页面使用.form、.dialogList、.dialogPage时,可自动解密参数并使用。内部的toXXX页面跳转相关方法参数处理也是使用的该方法。|
|beforeShow(params) | params:传入的参数|无|**注意:3.1.3704起新增!!!** 调用showXXX相关方法或__openDialog时,在打开弹框之前会调用该方法,可以进行部分逻辑处理,或修改params参数。|
|beforeJump(params) | params:传入的参数|无|**注意:3.1.3704起新增!!!** 调用toXXX相关方法或__pageJump时,在跳转页面之前会调用该方法,可以进行部分逻辑处理,或修改params参数。|
|$apiWithModule(methodName, params) | methodName:要调用的请求方法名称,必填。params:请求参数,选填。|Promise,请求成功进入.then且将返回值作为入参,失败则reject。|**注意:3.1.3702起新增!!!** 调用当前模块声明的moduleName中的请求方法。|
|$apiWithModule(methodName, params) | methodName:要调用的请求方法名称,必填。params:请求参数,选填。|Promise,请求成功进入.then且将返回值作为入参,失败则reject。|**注意:3.1.3702起新增!!!** 调用当前模块声明的moduleName中的请求方法。|
|resetQueryCondition(isQuery) | isQuery:boolean类型,非必填。true则代表重置后执行列表查询操作,false则代表只是重置操作。默认false|无|重置查询条件|
|changeQueryConditionCurrying(conditionKey) | conditionKey:要改变的属性名称。|(conditionValue, executeQuery) => void 返回一个匿名函数,该函数接受两个参数,arg0为conditionKey改变之后的值。arg1为是否执行查询的标识,boolean类型,默认为true。|改变查询条件并重新执行查询操作。|
|changeQueryCondition(conditionKey, conditionValue, executeQuery) | conditionKey:要改变的属性名称。conditionValue:要改变的值。executeQuery:是否立即执行查询操作,boolean类型,默认为true。|无|改变查询条件并重新执行查询操作。|
|getDefQueryCondition()|无|要设置给queryCondition的值|获取默认的查询条件,可用于初始化设置查询条件。**3.1.3705起,支持返回Promise!!**|
|getQueryLoadingTarget()|无|html对象或html对象的集合|查询时,需要添加遮罩的dom节点。需要将http的loading属性设置为false。**详见【http请求】章节**。|
|queryhandler(params)|params:k-v类型,要查询的参数|无|执行列表查询|
|getQueryCondition(params)|params:框架内部调用默认是queryHandler调用时传入的参数|处理之后的查询参数|获取查询条件,可以自定义queryCondition中没有的参数,**建议使用return Object.assign({}, this.queryCondition, params, {xxx:xxx})形式进行查询参数扩展,不建议直接修改queryCondition的值**|
|isExecuteQuery(condition)|condition:查询参数,框架内部调用默认是上方函数的返回值|boolean类型,true则代表即可以执行查询操作,false则代表不可以执行查询操作。|处理是否执行查询操作,默认返回true,执行查询操作。|
|queryBeforeHandler|无|无|发送查询请求之前的hook,下一步将发送查询请求|
|getResponseInfo(response)|response:列表查询请求的返回体|实际要用到的数据体|获取请求返回体中,需要用到的部分。|
|setResponseData(responseInfo)|responseInfo:经过getResponseInfo处理后拿到的接口数据体|无|用于绑定数据对象|
|querySuccessHandler(responseInfo)|responseInfo:描述同上|无|查询成功且绑定数据对象之后的hook|
|queryErrorHandler(error)|error:接口异常时,返回的异常对象|无|列表查询接口请求异常时的hook|
|queryAfterHandler|无|无|列表查询执行完毕后的hook。注意:不管查询接口是否成功,都会调用!|
|__pageJump(pageName, params)|pageName:要跳转的页面名称。params:要传递的参数。|无|跳转到指定name的页面,并将参数加密后放入地址栏。|