refactor(organization): 将所属组织搜索组件统一替换为级联选择器

- 全站搜索栏所属组织由树形下拉 (el-tree-select) 统一替换为级联选择器 (el-cascader)
- 修改多个视图和组件中所属组织相关表单与搜索逻辑,适配级联选择器数据结构
- 组织数据结构调整及新增 findOrgPath、findDeptPath 等方法支持路径反查与回显
- 表单模型与搜索参数中所属组织字段改用 ID 路径数组,提交时转换为名称
- 优化所属组织搜索UI,统一清除、过滤、提示等功能样式和行为
- 引入 organization-search mixin 支持组织数据加载、路径转换及搜索参数格式化
- 更新相关依赖组件 Element Plus 引入 ElCascader 替换 ElTreeSelect
- 修正搜索表单CSS,新增el-cascader全宽样式支持搜索栏布局一致性
- 兼容老数据,支持多种部门ID格式自动转换到单选路径数组格式
- 业务部门与承办部门表单同样应用级联选择器及路径转换逻辑
- 相关搜索配置项所属组织字段类型由 input 改为 cascader,提升搜索交互体验
This commit is contained in:
2026-08-31 12:19:18 +08:00
parent 3a08e12c65
commit 9b9e652afd
26 changed files with 515 additions and 192 deletions
+72 -14
View File
@@ -1,11 +1,11 @@
import { getDeptTree } from '@/api/system/dept';
import { ElTreeSelect } from 'element-plus';
import { ElCascader } from 'element-plus';
import { h } from 'vue';
/**
* 所属组织 统一搜索 mixin
* ------------------------------------------------------------------
* 全站「所属组织」搜索栏统一为树形下拉(el-tree-select),风格与客档案
* 全站「所属组织」搜索栏统一为级联选择器(el-cascader,单选),风格与客档案
* vehicle/customer-archive.vue)保持一致。
*
* 接入步骤(在使用了 avue-crud 的页面中):
@@ -15,24 +15,40 @@ import { h } from 'vue';
*
* 说明:
* - 自动识别 organizationName / deptName 两种 prop,并挂载 column.renderSearch
* - 树节点标识统一用 idnode-key='id'),返回值为部门 id
* - 树节点标识统一用 id,级联值为「根 → 选中节点」的 id 路径数组
* - checkStrictly 打开,任意层级(含非末级)都可直接选中
* - 页面若已有 excludeExternalOrganization / normalizeOrgTree 等方法,
* 组件自身方法优先级更高,会覆盖本 mixin 的默认实现
* - 搜索值id需在各自的 searchChange / normalizeSearch 中按后端要求
* 转换为部门名称(参考 contract-manage 的 normalizeSearch
* - 搜索值需在各自的 searchChange / normalizeSearch 中按后端要求转换为部门名称:
* 级联值是路径数组,统一用 findOrgById(路径)?.rawLabel 取末级名称
* - 表单区(新增/编辑)需要回显时,可用 findOrgPath(deptId) 把 id 转成路径,
* 参考 customer-archive 的 deptCascaderValue 计算属性
*/
const ORG_PROPS = ['organizationName', 'deptName'];
export default {
data() {
return {
// 树形组织数据,仅供搜索栏 el-tree-select 使用;
// 树形组织数据,仅供搜索栏 el-cascader 使用;
// 与页面自身 organizationOptions(多为表单扁平列表)隔离,避免相互覆盖
organizationTreeOptions: [],
organizationTreeFlatOptions: [],
organizationLoading: false,
};
},
computed: {
// 所属组织级联配置:checkStrictly 允许选中任意层级,不必选到末级
organizationCascaderProps() {
return {
value: 'id',
label: 'label',
children: 'children',
emitPath: true,
checkStrictly: true,
expandTrigger: 'click',
};
},
},
methods: {
loadOrganizationOptions() {
if (this.organizationLoading) return;
@@ -90,25 +106,67 @@ export default {
...this.flattenOrgTree(item.children || []),
]);
},
// 兼容两种入参:级联路径数组(取末级)或单个部门 id
findOrgById(id) {
const value = Array.isArray(id) ? id.at(-1) : id;
return this.organizationTreeFlatOptions.find(item => String(item.id) === String(value));
},
// 由部门 id 反查「根 → 该节点」的 id 路径,供级联回显(找不到返回 null)
findOrgPath(id, tree = this.organizationTreeOptions, parents = []) {
const target = Array.isArray(id) ? id.at(-1) : id;
if (target === undefined || target === null || target === '') return null;
for (const node of tree || []) {
const path = [...parents, String(node.id)];
if (String(node.id) === String(target)) return path;
const matched = this.findOrgPath(target, node.children, path);
if (matched) return matched;
}
return null;
},
// 由部门 id 取组织名称(末级),供表单提交
findOrgName(id) {
return this.findOrgById(id)?.rawLabel || '';
},
// 组织名称 → 级联路径(表单回显用;部门树异步加载完成后会自动重算)
resolveOrgPath(name) {
const value = String(name ?? '').trim();
if (!value) return [];
const node = this.organizationTreeFlatOptions.find(item => item.rawLabel === value);
return node ? this.findOrgPath(node.id) || [] : [];
},
// 级联路径 → 组织名称(表单/搜索提交用,取末级节点名称)
resolveOrgName(path) {
const value = Array.isArray(path)
? path.filter(item => item !== undefined && item !== null && item !== '')
: [];
return value.length ? this.findOrgById(value)?.rawLabel || '' : '';
},
// 搜索提交前把级联路径数组就地转成组织名称(后端按名称过滤)
normalizeOrganizationSearch(params, prop = 'organizationName') {
if (Array.isArray(params?.[prop])) {
params[prop] = this.resolveOrgName(params[prop]);
}
return params;
},
renderOrganizationSearch(scope, prop = 'organizationName') {
return h(ElTreeSelect, {
modelValue: scope.row?.[prop] || '',
return h(ElCascader, {
modelValue: Array.isArray(scope.row?.[prop]) ? scope.row[prop] : [],
'onUpdate:modelValue': value => {
if (scope.row) scope.row[prop] = value;
// 级联单选:modelValue 必须是 id 路径数组,否则控件内部状态会错乱导致无法再次选中
if (scope.row) scope.row[prop] = Array.isArray(value) ? value : [];
},
options: this.organizationTreeOptions,
props: {
label: 'label',
value: 'id',
children: 'children',
checkStrictly: true,
expandTrigger: 'click',
},
data: this.organizationTreeOptions,
'node-key': 'id',
'check-strictly': true,
filterable: true,
clearable: true,
'render-after-expand': false,
style: 'width: 100%',
placeholder: '请选择 所属组织',
props: { label: 'label', value: 'id', children: 'children' },
});
},
},