# selector-wrapper-search LLMs.txt

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

## 模块定位

选择器简单包装组件

## 导入方式

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

## 公开导出

- `* from ./selector-wrapper-search.jsx`
- `SelectorWrapperSearch` - 选择器简单包装组件
- `SelectorWrapperSearchServiceConfig`
- `SelectorWrapperSearchProps`

## 依赖的 antd 能力

`Button`、`Select`、`SelectProps`

## Props / 配置要点

### SelectorWrapperSearchServiceConfig

- `params`（可选）：: TPlainObject
- `onRequest`（可选）：: (params?: TAny) => TAny
- `requiredParamsKeys`（可选）：: string[]；与 params 配合使用
- `onRequestResultAdapter`（可选）：: (respData: TAny) => TPlainObject[]

### SelectorWrapperSearchProps

- `fieldNames`（可选）：: { label: string; value: string; disabled?: string; searchKeyword?: string; list?: string; }；参数Key映射
- `serviceConfig`（必填）：: SelectorWrapperSearchServiceConfig；请求服务需求的数据
- `showAllOption`（可选）：: true | TPlainObject<string | number>；添加全部选项
- `onSelectorListChange`（可选）：: (dataList: TPlainObject[]) => void；selectorList发生变更时触发，每次都会调用
- `onSelectorRequestError`（可选）：: (error: Error) => void；通过服务获取数据异常回调
- `requestMessageConfig`（可选）：: TRequestStatusProps['messageConfig']；交互文案配置
- `onLabelRenderAdapter`（可选）：: (dataItem: TPlainObject) => string | ReactElement；label渲染适配器

## 使用规则与行为

- 与 params 配合使用
- 参数Key映射
- 请求服务需求的数据
- 添加全部选项
- selectorList发生变更时触发，每次都会调用
- 通过服务获取数据异常回调
- 交互文案配置
- label渲染适配器
- 自定义keyword值,
- 选择器简单包装组件 @param props @returns

## 基础示例

```tsx
import { SelectorWrapperSearch, type SelectorWrapperSearchProps } from '@flatbiz/antd/selector-wrapper-search';

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

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

## 源码索引

- `src/selector-wrapper-search/index.ts`
- `src/selector-wrapper-search/selector-wrapper-search.tsx`

## 给 LLM 的注意事项

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