CondorTreeCheck
CondorTreeCheck 是一个树形勾选组件,从远程接口加载树形数据,支持全选/全不选、展开/折叠、父子联动、搜索过滤等功能。
组件 Props
| 参数名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| value | any | - | 绑定的值(选中的 key 数组) |
| url | string | - | 必需 远程数据接口 URL |
| checkStrategy | 'all' / 'parent' / 'child' | 'all' | 勾选策略:all-关联全部;parent-只关联父;child-只关联子 |
| multiple | boolean | false | 是否多选 |
| checkable | boolean | false | 是否显示勾选框 |
| labelField | string | 'name' | 显示名称字段 |
| keyField | string | 'id' | 选项值字段 |
| param | any | {} | 附加的请求参数 |
| format | string | 'string' | 输出格式:'string'-逗号分隔字符串;'array'-数组 |
| showLine | boolean | true | 是否显示连接线 |
| showIrrelevantNodes | boolean | false | 搜索时是否显示不相关节点 |
| childrenField | string | 'children' | 子节点字段名 |
| i18nkey | boolean | false | label 是否为国际化对象 |
| renderPrefix | Function | () => undefined | 节点前缀渲染函数 |
| renderSuffix | Function | () => undefined | 节点后缀渲染函数 |
| placeholder | any | '请选择' | 占位文本 |
组件事件
| 事件名 | 说明 | 参数 |
|---|---|---|
| update:value | 勾选值变化时触发 | 更新后的值(按 format 格式化) |
基本用法
vue
<template>
<CondorTreeCheck
v-model:value="checkedKeys"
url="/core/menu/tree"
checkable
:multiple="true"
format="array"
/>
</template>
<script setup lang="ts">
import { ref } from 'vue';
const checkedKeys = ref([]);
</script>组件内置三个控制开关:
- 展开/折叠:控制树节点的默认展开行为
- 全选/全不选:一键勾选或取消所有节点
- 父子联动:开启后勾选父节点自动勾选子节点(级联模式),关闭后父子独立