---
url: /components/tree-select.md
---
# TreeSelect 树形选择

下拉树选择器：[Tree](/components/tree) 与选择器的组合，支持单选 / 多选（复选框）、过滤、懒加载；层级数据用 `props` 字段映射。关闭态触发器支持键盘展开（Enter / Space / ↓）。

## 基础用法

## 多选（复选框）

`multiple` + `show-checkbox` 多选回显为标签；`check-strictly` 让父子选中互不联动：

## 回传值策略

多选复选默认按 `checked-strategy: child` 只回传叶子 key；改为 `parent` 时只回传「子级全选中」的最上层父节点（勾满一个大区只记大区，取消任一子级回退到仍全选中的最上层节点），`all` 则连同父级一起回传：

## 对象值形态

`label-in-value` 让绑定值形如 { value, label }（multiple 时为对象数组），业务侧免于二次反查文案；与 `checked-strategy` 组合时 label 取归约后 key 的文案：

## 过滤

`filterable` 按节点文案过滤；自定义过滤逻辑用 `filter-method`：

## 任意层级选择

单选默认只能选中叶子；加 `check-strictly` 后点击任意层级节点即可选中，展开/收起改由节点前箭头控制，常用于「选择部门或其上级」场景：

## 懒加载

`lazy` + `load` 按需拉取子级，展开时才请求；宿主侧把已加载子级合并进 `data`，保证选中回显始终有 label 可查：

## 禁用与事件

`disabled` 整体禁用（也可由 Form 注入）；`change` / `remove-tag` / `clear` / `visible-change` 覆盖值变更、删标签、清空与下拉开合：