# 何时使用

- 在气泡底部、工具条等位置展示一排可点击操作（复制、刷新、分享等）
- 操作项较多时需要「更多」收纳到 Popover 菜单
- 不适用：需要长按目标才弹出菜单的场景请用 `PopupAction`

---

# API

| 属性       | 类型                                      | 是否必传 | 默认值 | 说明                                       |
| ---------- | ----------------------------------------- | -------- | ------ | ------------------------------------------ |
| actions    | `Action[]`                                | 是       | `[]`   | 操作列表（无项时不渲染）                   |
| maxCount   | `number`                                  | 否       | `4`    | 直接展示的最大数量，超出部分进 Popover     |
| extra      | `React.ReactNode`                         | 否       | -      | 列表右侧额外区域                           |
| children   | `React.ReactElement`                      | 否       | -      | 自定义「更多」触发器，默认省略号图标       |
| itemRender | `(item: Action) => React.ReactNode`       | 否       | -      | 自定义单项渲染                             |
| direction  | `'ltr' \| 'rtl'`                          | 否       | `'ltr'`| 布局方向                                   |
| className  | `string`                                  | 否       | -      | 容器类名                                   |
| style      | `React.CSSProperties`                     | 否       | -      | 容器样式                                   |

### Action

| 属性     | 类型                                                | 是否必传 | 说明                         |
| -------- | --------------------------------------------------- | -------- | ---------------------------- |
| text     | `string`                                            | 是       | 文案（亦作 key 的一部分）    |
| icon     | `keyof typeof Icons` \| `React.ReactElement`        | 否       | `@alipay/sofa-icons` 图标名或自定义元素 |
| disabled | `boolean`                                           | 否       | `false`                      |
| onClick  | `() => void`                                        | 否       | 点击回调                     |

其余属性同 [Ant Design Mobile 的 Popover 菜单](https://mobile.ant.design/zh/components/popover)（本组件基于 `Popover.Menu` 实现溢出项）。

---

# FAQ

- 图标名为 sofa-icons 的导出键；需与项目已安装的图标包版本一致。