Skip to content

CondorTreeCheck

CondorTreeCheck 是一个树形勾选组件,从远程接口加载树形数据,支持全选/全不选、展开/折叠、父子联动、搜索过滤等功能。

组件 Props

参数名类型默认值说明
valueany-绑定的值(选中的 key 数组)
urlstring-必需 远程数据接口 URL
checkStrategy'all' / 'parent' / 'child''all'勾选策略:all-关联全部;parent-只关联父;child-只关联子
multiplebooleanfalse是否多选
checkablebooleanfalse是否显示勾选框
labelFieldstring'name'显示名称字段
keyFieldstring'id'选项值字段
paramany{}附加的请求参数
formatstring'string'输出格式:'string'-逗号分隔字符串;'array'-数组
showLinebooleantrue是否显示连接线
showIrrelevantNodesbooleanfalse搜索时是否显示不相关节点
childrenFieldstring'children'子节点字段名
i18nkeybooleanfalselabel 是否为国际化对象
renderPrefixFunction() => undefined节点前缀渲染函数
renderSuffixFunction() => undefined节点后缀渲染函数
placeholderany'请选择'占位文本

组件事件

事件名说明参数
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>

组件内置三个控制开关:

  • 展开/折叠:控制树节点的默认展开行为
  • 全选/全不选:一键勾选或取消所有节点
  • 父子联动:开启后勾选父节点自动勾选子节点(级联模式),关闭后父子独立