OpenAgentPack Kit
组件反馈

Actions 操作列表

回答下方的操作行:按钮与子菜单、复制与受控赞踩

Actions 把回答下方的操作组织成一行:用 items 配置按钮与子菜单,或组合 Actions.Copy 与 Actions.Feedback。Message 已为完成的回答内置复制入口, 用户消息悬停显示 iconOnly 形态。

import { Actions } from "@openagentpack/kit-chat-ui";

copy-in 接入(复制后 import 改为项目内路径):

pnpm kit:add actions

交给 coding agent 接入时使用 kit-components Skill;主题与渲染依赖见 组件总览。

何时使用

  • 回答下方操作行:复制入口 Message 已内置;需要「重新生成」等业务操作或赞踩评价时自行组合。
  • 复制要接宿主能力(Electron 剪贴板桥、远端上报):Actions.Copy 的 onCopy 注入实现。
  • 需要二级操作菜单:items 支持图标、禁用、danger 提示与 subItems 子菜单。

代码演示

预览使用本地数据;演示面板内可查看源码与接入命令。

基本用法

items 配置按钮与二级子菜单;点击叶子项回传 key 并自动收起弹层,Escape 或点击外部也可收起。

Actions(操作项与子菜单)

复制(Actions.Copy)

默认走浏览器剪贴板;勾选「注入宿主失败」观察 onCopy 抛错后的失败状态,「仅图标」切换 iconOnly 形态。

Actions.Copy(复制与宿主注入)

赞踩反馈(Actions.Feedback)

受控组件:赞与踩互斥,再次点击当前选项回到 default;保存评价与上报埋点由调用方完成。

Actions.Feedback(受控赞踩)

API

Actions

属性说明类型默认值
items操作按钮与子菜单配置ActionsItem[][]
onClick可用叶子项点击后的统一回调;展开子菜单本身不触发(info: ActionsClickInfo) => void—
children组合 Actions.Copy、Actions.Feedback 或自定义操作ReactNode—
variantitems 按钮外观;组合子组件可分别设置"borderless" | "outlined" | "filled""borderless"
className根节点的 Tailwind 工具类string—
aria-label操作组的无障碍名称string"操作列表"

ActionsItem

属性说明类型
key唯一业务标识string
label操作文字ReactNode
icon可选图标ReactNode
disabled禁用该项boolean
danger危险操作的视觉提示;不代替业务确认boolean
onItemClick单项回调(info: ActionsClickInfo) => void
subItems点击后展开的子操作ActionsItem[]

ActionsClickInfo 包含 key、被点击的 item 与原始 domEvent。涉及删除会话等不可逆操作时, 调用方仍须先展示影响并走 AlertDialog 确认。

Actions.Copy

属性说明类型默认值
text待复制的原始文字string必填
onCopy注入复制实现:成功 resolve,失败抛错;省略时用浏览器剪贴板(text: string) => void | Promise<void>浏览器剪贴板
label按钮名称与无障碍名称string"复制"
iconOnly只显示图标(无障碍名称仍读 label),复制状态文字照常出现booleanfalse
disabled禁止复制booleanfalse
variant按钮外观"borderless" | "outlined" | "filled""borderless"
classNameTailwind 工具类string—

复制状态由真实异步结果决定(复制中… / 已复制 / 复制失败,请重试),不把拒绝的剪贴板权限展示成成功; 状态文字同时写入 sr-only 区域供读屏使用。

Actions.Feedback

属性说明类型默认值
value调用方持有的反馈值"default" | "like" | "dislike"必填
onChange新反馈值:重复点击当前选项回传 default(value: "default" | "like" | "dislike") => void必填
disabled禁止修改反馈booleanfalse
variant按钮外观"borderless" | "outlined" | "filled""borderless"
classNameTailwind 工具类string—

主题变量(Design Token)

引入 @openagentpack/kit-chat-ui/theme.css 后使用以下冻结 token。下表列出亮色值, 暗色由 data-kit-theme="dark" 使用对应色板。

Token用途默认主题工作区主题
--kit-bg-subtle按钮悬停底色、filled 变体与子菜单触发器的悬停底色#f6f7fb#f7f7f7
--kit-borderoutlined 变体描边、子菜单弹层描边#e3e6ef#e5e5e5
--kit-surface子菜单弹层底色#ffffff#ffffff
--kit-fg-muted默认按钮文字与图标#5b6478#737373
--kit-accent选中态赞/踩高亮#4f46e5#171717
--kit-dangerdanger 项与复制失败文字#dc2626#ad372f

子菜单弹层阴影用 --kit-shadow;键盘焦点环用 --kit-focus,按钮圆角走 --kit-radius-sm、 文字档位 --kit-text-caption。更多主题配置见 组件总览。

本页目录