# tree-modal-selector LLMs.txt

> 供 LLM 快速理解 `@flatbiz/antd/tree-modal-selector` 的使用方式。

## 模块定位

树弹框选择器

## 导入方式

```ts
import { TreeModalSelector } from '@flatbiz/antd/tree-modal-selector';
// 也可以从主入口导入：import { ... } from '@flatbiz/antd';
```

## 公开导出

- `* from ./selector.jsx`
- `TreeModalSelector` - 树弹框选择器
- `TreeModalSelectorProps`
- `TreeModalSelectorApi`

## 依赖的 antd 能力

`message`、`Select`

## Props / 配置要点

### TreeModalSelectorProps

- `placeholder`（可选）：: string
- `maxTagCount`（可选）：: number | 'responsive'；1. 可指定数量 2. 可设置 responsive，一行自适应显示
- `labelInValue`（可选）：: boolean；是否返回label+value模式
- `onChange`（可选）：: (values?: TreeModelSelectItem[] | TreeModelSelectItem) => void
- `maxCount`（可选）：: number；最大选择数量
- `overMaxCountMsg`（可选）：: string；超过最大选择数量提示文本
- `disabled`（可选）：: boolean
- `allowClear`（可选）：: boolean

## 使用规则与行为

- 1. 可指定数量 2. 可设置 responsive，一行自适应显示
- 是否返回label+value模式
- 最大选择数量
- 超过最大选择数量提示文本
- 树弹框选择器

## 默认值线索

- `placeholder => '请选择'`
- `allowClear => true`

## 基础示例

```tsx
import { TreeModalSelector, type TreeModalSelectorProps } from '@flatbiz/antd/tree-modal-selector';

const props: TreeModalSelectorProps = {
  // 按业务传入必要参数
};

<TreeModalSelector {...props} />;
```

## 源码索引

- `src/tree-modal-selector/index.ts`
- `src/tree-modal-selector/selector.tsx`

## 给 LLM 的注意事项

- 优先使用 `@flatbiz/antd/tree-modal-selector` 或主入口 `@flatbiz/antd` 的公开导出，不要引用内部实现文件。
- 当 Props 与 antd 原组件同名能力冲突时，以本模块导出的 Props 类型为准。
- 若文档未覆盖某个边缘参数，请读取上方源码索引中的类型定义和 JSDoc。