# button-operate LLMs.txt

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

## 模块定位

按钮组合处理组件

## 导入方式

```ts
import { ButtonOperate } from '@flatbiz/antd/button-operate';
// 也可以从主入口导入：import { ... } from '@flatbiz/antd';
```

## 公开导出

- `ButtonOperateItemContent`
- `ButtonOperate` - 按钮组合处理组件
- `ButtonOperateItem`
- `ButtonOperateProps`
- `* from ./button-operate.jsx`

## 依赖的 antd 能力

`Button`、`Divider`、`Popconfirm`、`PopconfirmProps`、`Popover`、`Space`、`SpaceProps`、`Tooltip`

## Props / 配置要点

### ButtonOperateItem

- `hoverTips`（可选）：: string | ReactElement；hover 提示文字，isFold=true无效
- `tipsType`（可选）：: 'popover' | 'tooltip'；hover 提示类型 默认：'tooltip'
- `text`（可选）：: string | ReactElement；按钮文案
- `color`（可选）：: string；自定义按钮颜色
- `needConfirm`（可选）：: boolean；是否需要二次弹框确认
- `confirmMessage`（可选）：: ReactNode；二次弹框确认文案
- `isFold`（可选）：: boolean；是否折叠合拢
- `show`（可选）：: boolean；是否显示按钮，优先级高于 hidden

### ButtonOperateProps

- `className`（可选）：: string
- `style`（可选）：: CSSProperties
- `operateList`（必填）：: Array<ButtonOperateItem | null | ReactElement>；如果数组中元素为ReactElement类型 1. 一般为antd Button组件，如果组件存在属性hidden=true、v-hidden=true，则会隐藏 2. 可配置 v-permission 权限值，例如 v-permission="add" 3. 任何confirm、disabled等状态在外部控制 3. 不支持fold效果
- `wrap`（可选）：: boolean；是否换行，默认true
- `foldIcon`（可选）：: ReactElement；隐藏图标Icon
- `split`（可选）：: boolean；按钮之间是否添加分隔符
- `spaceProps`（可选）：: SpaceProps；多个按钮的包装组件Space属性
- `gap`（可选）：: number；间距，默认：10；split=true配置下无效（可通过spaceProps设置间距）
- `dropdownMenuProps`（可选）：: Omit<DropdownMenuWrapperProps, 'menuList'>；折叠合拢属性
- `size`（可选）：: 'small' | 'default'；按钮布局尺寸

## 使用规则与行为

- hover 提示文字，isFold=true无效
- hover 提示类型 默认：'tooltip'
- 按钮文案
- 自定义按钮颜色
- 是否需要二次弹框确认
- 二次弹框确认文案
- 是否折叠合拢
- 是否显示按钮，优先级高于 hidden
- 如果数组中元素为ReactElement类型 1. 一般为antd Button组件，如果组件存在属性hidden=true、v-hidden=true，则会隐藏 2. 可配置 v-permission 权限值，例如 v-permission="add" 3. 任何confirm、disabled等状态在外部控制 3. 不支持fold效果
- 是否换行，默认true

## 默认值线索

- `gap => 10`

## 基础示例

```tsx
import { ButtonOperate, type ButtonOperateProps } from '@flatbiz/antd/button-operate';

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

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

## 源码索引

- `src/button-operate/button-operate.tsx`
- `src/button-operate/index.ts`

## 给 LLM 的注意事项

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