注意:本章節介紹的是基礎封裝,所有內置封裝均繼承自基礎封裝并進行了擴展!
```
<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的頁面,并將參數加密后放入地址欄。|