# selector-wrapper LLMs.txt

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

## 模块定位

选择器包装组件

## 导入方式

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

## 公开导出

- `* from ./selector-wrapper.jsx`
- `RefreshIcon`
- `SelectorWrapper` - 选择器包装组件
- `* from ./types.js`
- `SelectorWrapperValue`
- `SelectorServiceConfig`
- `SelectorWrapperProps`
- `useRequest`
- `getVauleList` - value存在两种格式 1. string | number; 2. labelInValue 格式

## 依赖的 antd 能力

`Button`、`Select`、`SelectProps`

## Props / 配置要点

### SelectorServiceConfig

- `params`（可选）：: TPlainObject
- `requiredParamsKeys`（可选）：: string[]；与 params 配合使用
- `onRequest`（可选）：: (params?: TAny) => Promise<TAny>
- `onRequestResultAdapter`（可选）：: (respData: TAny) => TPlainObject[]；响应数据适配器

### SelectorWrapperProps

## 使用规则与行为

- 选择器包装组件
- 与 params 配合使用
- 响应数据适配器
- 不支持 tags 模式，tags模式请使用 SelectorWrapperSimple 组件
- 设置请求唯一值
- 参数Key映射
- 请求服务需求的数据
- 同步设置选择器选项列表
- select 数据源发生变更时触发，第一次不调用
- select 数据源发生变更时触发，每次都会调用

## 默认值线索

- `useCache => true`

## 基础示例

```tsx
import { SelectorWrapper, type SelectorWrapperProps } from '@flatbiz/antd/selector-wrapper';

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

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

## 源码索引

- `src/selector-wrapper/index.ts`
- `src/selector-wrapper/refresh-icon.tsx`
- `src/selector-wrapper/selector-wrapper.tsx`
- `src/selector-wrapper/types.ts`
- `src/selector-wrapper/use-request.ts`
- `src/selector-wrapper/utils.ts`

## 给 LLM 的注意事项

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