# easy-form LLMs.txt

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

## 模块定位

简单Form布局，可自定义网格布局

## 导入方式

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

## 公开导出

- `EasyForm` - 简单Form布局，可自定义网格布局
- `EasyFormProps`
- `* from ./form.jsx`

## 依赖的 antd 能力

`Form`

## Props / 配置要点

### EasyFormProps

- `forceColumn`（可选）：: 1 | 2 | 3 | 4；强制定义一行显示几列，不考虑响应式
- `width`（可选）：: number | string；Form显示宽度，可数值、可百分比；在小屏幕尺寸（xs、sm）上无效
- `gridGutter`（可选）：: BoxRowProps['gutter']；网格间距
- `children`（必填）：: ReactNode
- `isPure`（可选）：: boolean；是否为纯净模式，对EasyForm的子节点不做任何包装处理
- `span`（可选）：: number；栅格占位格数，最大值：24

## 使用规则与行为

- 定义一行显示几列（当外层宽度尺寸大于 992px（lg） 时，一行显示几列）, 默认值：3
- 强制定义一行显示几列，不考虑响应式
- Form显示宽度，可数值、可百分比；在小屏幕尺寸（xs、sm）上无效
- 网格间距
- 是否为纯净模式，对EasyForm的子节点不做任何包装处理
- 栅格占位格数，最大值：24
- 简单Form布局，可自定义网格布局
- 小屏幕不控制宽度

## 默认值线索

- `gridGutter => ([15, 0] as GutterParams)`

## 基础示例

```tsx
import { EasyForm, type EasyFormProps } from '@flatbiz/antd/easy-form';

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

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

## 源码索引

- `src/easy-form/form.tsx`
- `src/easy-form/index.ts`

## 给 LLM 的注意事项

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