# button-wrapper LLMs.txt

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

## 模块定位

antd Button包装组件 1. 添加按钮 onClick 返回 Promise自动loading效果 2. 内置 防抖 效果（在第一触发函数后，在指定时间内再次触发无效，即两次触发的时间间隙大于指定时间）

## 导入方式

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

## 公开导出

- `ButtonWrapper` - antd Button包装组件 1. 添加按钮 onClick 返回 Promise自动loading效果 2. 内置 防抖 效果（在第一触发函数后，在指定时间内再次触发无效，即两次触发的时间间隙大于指定时间）
- `ButtonWrapperProps`
- `* from ./button-wrapper.jsx`

## 依赖的 antd 能力

`Button`、`ButtonProps`

## Props / 配置要点

### ButtonWrapperProps

- `onClick`（可选）：: (e: React.MouseEvent) => Promise<TAny> | void；当返回 Promise 时，按钮自动loading
- `debounceDuration`（可选）：: number；重复点击间隙，单位毫秒 默认值：500
- `permission`（可选）：: string；基于GLOBAL中elemAclLimits按钮权限列表，控制按钮显示、隐藏
- `hidden`（可选）：: boolean；是否隐藏按钮
- `loadingPosition`（可选）：: 'left' | 'center'；loading 显示位置，默认值：left
- `removeGap`（可选）：: boolean；移除按钮内边距，一般用于 type=link 类型下
- `color`（可选）：: string

## 使用规则与行为

- 当返回 Promise 时，按钮自动loading
- 重复点击间隙，单位毫秒 默认值：500
- 基于GLOBAL中elemAclLimits按钮权限列表，控制按钮显示、隐藏
- 是否隐藏按钮
- loading 显示位置，默认值：left
- 移除按钮内边距，一般用于 type=link 类型下
- antd Button包装组件 1. 添加按钮 onClick 返回 Promise自动loading效果 2. 内置 防抖 效果（在第一触发函数后，在指定时间内再次触发无效，即两次触发的时间间隙大于指定时间） @param props @returns

## 默认值线索

- `loadingPosition => 'left'`
- `debounceDuration => 500`

## 基础示例

```tsx
import { ButtonWrapper, type ButtonWrapperProps } from '@flatbiz/antd/button-wrapper';

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

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

## 源码索引

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

## 给 LLM 的注意事项

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