**JSelectDept部門選擇框** ***** [TOC] ## 參數定義 | 參數 | 類型 | 是否必填 | 默認值 | 說明 | | --- | --- | --- | --- | --- | | value | \[String,Array\] | 否 | 無 | 回顯值 | | showButton | Boolean | 否 | true | 是否顯示選擇按鈕 | | disabled | Boolean | 否 | false | 是否禁用 | | rowKey | String | 否 | key | 取值字段配置,一般為主鍵字段 | | labelKey | String | 否 | title | 顯示字段配置 | | defaultExpandLevel | String | 否 | 0 | 初始展開層級 | | checkStrictly | Boolean | 否 | false | 父子節點選中狀態不再關聯 | | checkable | Boolean | 否 | true | 是否顯示復選框 | | startPid | String | 否 | \- | 根節點初始值（serverTreeData不開啟服務端數據轉換時使用） | | primaryKey | String | 否 | id | 主鍵字段 | | parentKey | String | 否 | parentId | 父ID字段 | | titleKey | String | 否 | title | tree節點顯示文本字段 | | serverTreeData | Boolean | 否 | true | 是否開啟服務端數據轉換 | | sync | Boolean | 否 | true | 是否開啟異步加載數據 | | multiple | Boolean | | true | `v1.1.0` 是否允許多選 | | ~~params~~ | String | 否 | \- | ~~自定義查詢參數，需要傳遞字符串，如：params:**'{"orgCode":"A01"}'**~~ | | modalTitle| String| 否 | 部門選擇| 選擇框標題| ## 事件定義 | 事件名 | 參數 | 說明 | | --- | --- | --- | | getSelectResult | options, values | 確認選擇回調，單獨使用選擇框中使用該事件獲取選中值 | ## tree要求的數據格式 ``` [{ "key": "1", "title": "節點1", "children":[ { key:"1-1", title:"子節點", children:[] } ] },{ "key": "2", "departName": "節點2", "children":[] } ] ``` ## 使用示例 ### BaseForm中使用示例   ~~~ { field: 'user2', component: 'JSelectDept', label: '選擇示例', helpMessage: ['component模式'], componentProps:{ labelKey:'departName', rowKey:'orgCode' } } ~~~ ### 插槽中使用示例 ~~~ <template #jSelectDept="{model, field }"> <JSelectDept v-model:value="model[field]"/> </template> ~~~ ### 單獨使用示例 ~~~ <template> <a-button type="primary" preIcon="ant-design:plus-outlined" @click="openHandle">選擇</a-button> <DeptSelectModal rowKey="id" @register="registerSelModal" @getSelectResult="onSelectOk"/> </template> <script lang="ts" setup> import DeptSelectModalfrom '/@/components/Form/src/jeecg/components/modal/DeptSelectModal.vue' // 注冊選擇框 const [registerSelModal, {openModal}] = useModal() let selectValues = reactive<Recordable>({ //附值value value: [], }); //下發 selectValues provide('selectValues', selectValues); // 打開選擇框 function openHandle() { openModal()； } // 選擇確認事件 function onSelectOk(selectRows, selectKeys) { //處理業務邏輯 } </script> ~~~ ### 前端轉換tree數據結構 如下數據所示，后臺返回的數據結構不是樹形的但是必須的含有parentId，此時需要設置serverTreeData=false，開啟前端轉換為tree結構數據，并指定titleKey為departName,primaryKey為deptId，parentKey為parentId ``` [{ "deptId": "1", "parentId": "", "departName": "節點1", },{ "deptId": "2", "parentId": "", "departName": "節點2", } ] ``` 代碼示例 ``` { label: '所屬部門', field: 'selecteddeparts', component: 'JSelectDept', componentProps:({formActionType,formModel}) => { return { titleKey:"departName", primaryKey:"id", parentKey:"parentId", serverTreeData:false } } } ``` ### 開啟異步加載 當數據量過大時，我們希望tree是異步加載，此時可設置sync:true開啟異步加載，如果數據結構不符合需要開啟前端轉換tree結構數據 代碼示例 ``` { label: '所屬部門', field: 'selecteddeparts', component: 'JSelectDept', componentProps:({formActionType,formModel}) => { return { sync:true } } } ```