# drag-editable-card LLMs.txt

> 供 LLM 快速理解 `@flatbiz/antd/drag-editable-card` 的使用方式。

## 模块定位

可拖拽编辑卡片

## 导入方式

```ts
import { DragEditableCard } from '@flatbiz/antd/drag-editable-card';
// 也可以从主入口导入：import { ... } from '@flatbiz/antd';
```

## 公开导出

- `DragEditableCard` - 可拖拽编辑卡片
- `DragEditableCardProps`
- `Handle`
- `Handle2`
- `* from ./editable-card.jsx`

## 依赖的 antd 能力

`Form`、`FormListFieldData`、`FormListOperation`、`Space`

## Props / 配置要点

### DragEditableCardProps

- `dragIcon`（可选）：: ReactElement；拖拽图标自定义，默认使用 DragOutlined 图标
- `disabledDrag`（可选）：: boolean；禁用拖拽
- `uidFieldKey`（必填）：: string；表格数据唯一值字段Key
- `onDragChange`（可选）：: ( dataSource: TPlainObject[], dragData: { activeId: string | number; overId?: string | number; activeIndex: number; overIndex: number; } ) => void；拖拽结束事件
- `dragTriggerPosition`（可选）：: 'left' | 'right'；拖拽触发位置，默认在左侧

### HandleProps

- `dragIcon`（可选）：: ReactElement
- `rowId`（必填）：: string
- `children`（必填）：: ReactElement
- `extraData`（可选）：: { operation: FormListOperation; fields: FormListFieldData[]; index: number; required?: boolean; }
- `dragTriggerPosition`（可选）：: 'left' | 'right'
- `onCustomGroupName`（可选）：: (index: number) => string | ReactElement

### Handle2Props

- `children`（必填）：: ReactElement
- `extraData`（可选）：: { operation: FormListOperation; fields: FormListFieldData[]; index: number; required?: boolean; }
- `onCustomGroupName`（可选）：: (index: number) => string | ReactElement

## 使用规则与行为

- 拖拽图标自定义，默认使用 DragOutlined 图标
- 禁用拖拽
- 表格数据唯一值字段Key
- 拖拽结束事件
- 拖拽触发位置，默认在左侧
- 可拖拽编辑卡片

## 基础示例

```tsx
import { DragEditableCard, type DragEditableCardProps } from '@flatbiz/antd/drag-editable-card';

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

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

## 源码索引

- `src/drag-editable-card/editable-card.tsx`
- `src/drag-editable-card/handle.tsx`
- `src/drag-editable-card/handle2.tsx`
- `src/drag-editable-card/index.ts`

## 给 LLM 的注意事项

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