# form-item-wrapper LLMs.txt

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

## 模块定位

对 Form.Item 包装处理

## 导入方式

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

## 公开导出

- `FormItemWrapper` - 对 Form.Item 包装处理
- `FormItemWrapperProps`
- `* from ./form-item-wrapper.jsx`

## 依赖的 antd 能力

`Form`、`FormItemProps`

## Props / 配置要点

### FormItemWrapperProps

- `wrapper`（可选）：: (children: ReactNode) => ReactElement
- `before`（可选）：: ReactNode；设置wrapper后，before、after失效
- `after`（可选）：: ReactNode；设置wrapper后，before、after失效
- `beforeAfterStyle`（可选）：: CSSProperties；设置 before、after 属性的包装结构style
- `inputNormalize`（可选）：: (value?: TAny) => TAny；value 序列化处理
- `outputNormalize`（可选）：: (value?: TAny) => TAny；onChange 参数序列化处理 如果设置 normalize 属性，outputNormalize将失效
- `isClear`（可选）：: boolean | ((formValues: TPlainObject) => boolean)；隐藏 Form.Item，同时清除 Form.Item 值
- `hidden`（可选）：: boolean | ((formValues: TPlainObject) => boolean)；隐藏 Form.Item，不会清除 Form.Item 值
- `span`（可选）：: number；栅格占位格数，最大值：24
- `children`（可选）：: ReactNode；不支持函数式写法，如果需要使用dependencies获取表单值，可使用FormItemWrapperDependencies 组件
- `noStyle`（可选）：: boolean
- `bottomGap`（可选）：: number；底部间隙

### FormItemWrapperChildrenProps

- `children`（必填）：: ReactElement
- `value`（可选）：: any
- `onChange`（可选）：: (value?: any) => any

## 使用规则与行为

- 设置wrapper后，before、after失效
- 设置 before、after 属性的包装结构style
- value 序列化处理
- onChange 参数序列化处理 如果设置 normalize 属性，outputNormalize将失效
- 隐藏 Form.Item，同时清除 Form.Item 值
- 隐藏 Form.Item，不会清除 Form.Item 值
- 栅格占位格数，最大值：24
- 不支持函数式写法，如果需要使用dependencies获取表单值，可使用FormItemWrapperDependencies 组件
- 底部间隙
- 对 Form.Item 包装处理

## 基础示例

```tsx
import { FormItemWrapper, type FormItemWrapperProps } from '@flatbiz/antd/form-item-wrapper';

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

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

## 源码索引

- `src/form-item-wrapper/form-item-wrapper.tsx`
- `src/form-item-wrapper/index.ts`

## 给 LLM 的注意事项

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