# cascader-wrapper LLMs.txt

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

## 模块定位

级联选择器包装组件

## 导入方式

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

## 公开导出

- `CascaderWrapper` - 级联选择器包装组件
- `CascaderWrapperProps`
- `CascaderWrapperRefApi`
- `* from ./cascader-wrapper.jsx`
- `getValues`

## 依赖的 antd 能力

`Button`、`Cascader`、`CascaderProps`、`Flex`

## Props / 配置要点

### CascaderWrapperServiceConfig

- `params`（可选）：: TPlainObject
- `onRequest`（可选）：: (params?: TAny) => TAny
- `onRequestResultAdapter`（可选）：: (respData: TAny) => TPlainObject[]；响应数据适配器
- `requiredParamsKeys`（可选）：: string[]；必填字段设置

### CascaderWrapperProps

- `fieldNames`（可选）：: { list?: string; label?: string; value?: string; children?: string; }；参数Key映射
- `serviceConfig`（可选）：: CascaderWrapperServiceConfig；请求服务需求的数据，当设置selectorList后无效果
- `onSelectorListChange`（可选）：: (dataList: TPlainObject[]) => void
- `isDynamicLoad`（可选）：: boolean；是否动态加载选项
- `value`（可选）：: | string | number | Array<string | number> | LabelValueItem | LabelValueItem[]
- `onChange`（可选）：: ( value?: string | number | Array<string | number>, selectedList?: TPlainObject[] ) => void
- `requestMessageConfig`（可选）：: TRequestStatusProps['messageConfig']；配置数据查询状态描述，比如有依赖字段描述
- `labelInValue`（可选）：: boolean；响应数据是否包含label、value

## 使用规则与行为

- 响应数据适配器
- 必填字段设置
- 参数Key映射
- 请求服务需求的数据，当设置selectorList后无效果
- 是否动态加载选项
- 配置数据查询状态描述，比如有依赖字段描述
- 选择数据响应类型（当用户选中后响应数据）,默认值：last
- 响应数据是否包含label、value
- 级联选择器包装组件

## 基础示例

```tsx
import { CascaderWrapper, type CascaderWrapperProps } from '@flatbiz/antd/cascader-wrapper';

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

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

## 源码索引

- `src/cascader-wrapper/cascader-wrapper.tsx`
- `src/cascader-wrapper/index.ts`
- `src/cascader-wrapper/utils.ts`

## 给 LLM 的注意事项

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