# form-item-group LLMs.txt

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

## 模块定位

FormItem 水平布局

## 导入方式

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

## 公开导出

- `FormItemCard`
- `FormItemCardProps`
- `FormItemHorizontalUnion` - FormItem 水平布局
- `FormItemHorizontalUnionProps`
- `FormItemGroup`

## 依赖的 antd 能力

`Form`

## Props / 配置要点

### FormItemCardProps

- `title`（可选）：: string | ReactElement
- `children`（必填）：: ReactElement | ReactElement[]
- `className`（可选）：: string
- `style`（可选）：: CSSProperties
- `titleSign`（可选）：: boolean

### FormItemHorizontalUnionProps

- `className`（可选）：: string
- `style`（可选）：: CSSProperties
- `label`（可选）：: string | ReactElement
- `groupConfigList`（可选）：: { hidden?: boolean; before?: ReactElement | string; width?: number | string; mainItem: ReactElement; after?: ReactElement | string; }[]；水平布局元素
- `gap`（可选）：: number；水平布局原始之间的间距
- `flexLayoutStyle`（可选）：: CSSProperties
- `flexLayoutClassName`（可选）：: string
- `hidden`（可选）：: boolean
- `required`（可选）：: boolean
- `colon`（可选）：: boolean

## 使用规则与行为

- 水平布局元素
- 设置宽度
- 水平布局原始之间的间距
- FormItem 水平布局 @param props @returns

## 默认值线索

- `gap => 15`

## 基础示例

```tsx
import { FormItemGroup, type FormItemCardProps } from '@flatbiz/antd/form-item-group';

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

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

## 源码索引

- `src/form-item-group/card/index.tsx`
- `src/form-item-group/horizontal-union/index.tsx`
- `src/form-item-group/index.ts`

## 给 LLM 的注意事项

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