专业版

FaTree 树形控件

树形数据展示组件，支持节点展开/收起、选择、复选框、搜索过滤和自定义节点。

使用场景

属性	类型	默认值	说明
`data`	`TreeNode[]`	必需	树形数据
`checkable`	`boolean`	`false`	是否显示复选框
`filterable`	`boolean`	`false`	是否显示搜索框
`virtualList`	`boolean`	`false`	是否启用虚拟化列表
`treeClass`	`HTMLAttributes['class']`	-	树根节点的 class
`filterPlaceholder`	`string`	`'搜索...'`	搜索框占位文本
`nodeKey`	`string`	-	节点唯一标识字段名
`defaultExpandAll`	`boolean`	`false`	是否默认展开所有节点
`filterMethod`	`(query: string, node: TreeNode) => boolean`	-	自定义过滤方法
`class`	`HTMLAttributes['class']`	-	自定义 CSS 类

interface TreeNode extends Record<string, any> {
  label: string
  children?: TreeNode[]
  checked?: boolean
  disabled?: boolean
}

名称	说明	作用域参数
`default`	自定义节点内容	`node: TreeNode` - 当前节点 `expanded: boolean` - 是否展开

事件名	说明	回调参数
`selection-change`	选中节点变化时触发（非复选模式）	`node: TreeNode \| null`
`check-change`	复选框状态变化时触发	`nodes: TreeNode[]` - 所有选中节点

方法名	说明	参数
`expand`	展开节点	`nodeIds?: string[]` - 节点 ID 数组，不传则展开所有
`collapse`	收起节点	`nodeIds?: string[]` - 节点 ID 数组，不传则收起所有
`checkAll`	全选/取消全选	`checked: boolean` - 是否全选
`setSelection`	设置选中节点	`id: string` - 节点 ID
`clearSelection`	清除选择	无