RowActions

何时用

表格「操作」列里那一排动作（查看 / 编辑 / 导出 / 删除）。它管的是行操作这个模式本身的形状：谁重谁轻、多了怎么收、破坏性的怎么拦、禁用的怎么解释。

页面级的批量操作栏用 ProTable 的 batchActions；工具栏用 toolbarActions；单独一颗按钮就用 Button，不必套这一层。

导入

Props

RowActionItem：

动效

动作按钮（含溢出菜单键）带库的按压反馈：按下轻微缩放，时长与曲线取自动效体系的 fast 档，prefers-reduced-motion: reduce 下自动去掉——这条偏好一律由库负责，不必在调用处关。这份手感来自 Button 底座（BUTTON_BASE_CLASS），全库走 <Button> 的地方一致，RowActions 不额外做什么。

revealOnHover 的显隐同样走 fast 档的过渡，减弱动效下变成直接切换。

异步动作

onSelect 返回 Promise 时组件自己处理这一整套，消费方不必再传 loading / disabled：

• 这个动作转圈，同一行里其他动作暂时点不动——一行里同时发两个写操作，服务端看到的顺序基本是随机的
• 有 confirm 时确认键跟着转圈，成功才关框；失败留在原地让用户能重试
• 执行期间 Esc / 点遮罩 / 取消键都关不掉框：动作还在飞就关掉，用户会以为自己取消了，而它根本没被取消
• reject 时组件只结束 loading，不显示任何错误文案——那是业务语义，请在 onSelect 里自己 catch 并 toast

三档怎么选

三档的语气色一致（tone 说了算），溢出菜单键也跟着档位走——按钮档里不会冒出一颗无边框的「⋯」。

动作之间的间距也按档给：文字档 16px，按钮档与图标档 4px。不是一个常数，因为文字档的按钮是
variant="link"，而 link 在 Button 里被钉了 px-0（纯文字链接，文字左缘要与表头对齐）——
两个动作之间的全部间隔就只剩这个 gap；另外两档的按钮自带横向内边距，视觉间隔是 gap + 2×padding。
给同一个数，文字档就会挤成一句话。

设计判据

• 超出时露出 `max - 1` 个而不是 `max` 个：菜单键本身也占一格，露满 max 再加一颗「⋯」，实际控件数就是 max + 1，列宽会比调用方以为的宽一格。
• 破坏性动作在菜单里排最后并用分隔线隔开：菜单是「手滑就点中」的地方，把删除排在编辑旁边等于鼓励误触。
• 禁用不用原生 `disabled`：原生禁用的按钮既不可聚焦、也不派发指针事件，于是「这个按钮为什么是灰的」这条提示永远弹不出来——而那正是最需要它的时候。组件改用 aria-disabled + 点击短路，名字仍可读、提示仍可弹、键盘仍可到达。
• 确认框由组件自己持有，不走命令式 modal.confirm：后者要求消费方在根上挂 <ModalProvider />，漏挂时是静默无事发生——用户点了删除、什么都没弹、动作也没跑，控制台一声不响。行操作是最不该踩这个的地方。自持还有一个好处：同一个动作被折进菜单前后，确认体验完全一致。
• 导航型动作走 `render`：用 onSelect 做 router.push 会丢掉 Cmd+点击开新标签、中键、右键复制链接——这些是后台用户天天用的原生能力，只有真的渲染成 <a> 才有。

禁忌 / 坑

• label 是 string 不是 ReactNode，因为它要同时当无障碍名、提示文案与菜单检索词，这三处都只认字符串。要富文本请重新想想这个动作名是不是太长了。
• 图标档里每项都该有 icon：没有的话按钮会是空的，只剩无障碍名——那是能读不能看。
• hidden 与 disabled 别混：没权限用 `hidden`（不该让人知道有这个动作），当前状态不允许用 `disabled` + `disabledReason`（该让人知道为什么现在不行）。
• 窄屏不会自动少露几个：max 是个定值。列宽紧张时请自己按断点传更小的 max，或者换 variant="icon"。刻意没做容器查询自动降档——操作列的宽度本身就由内容决定，再让内容反过来跟着宽度变会绕成循环，实测不稳定。
• 全部动作被 hidden 筛掉时组件什么都不渲染（不是留个空壳），所以别指望它撑出列宽。
• 一行超过 5 个动作时先想想是不是该做成批量操作或详情页里的操作，而不是继续加 max。

相关

Table · ProTable · Button · Menu · AlertDialog · Popconfirm