组件/TaskRows 任务行

TaskRows 任务行

带状态与可展开明细的智能体任务行

Verified自 0.3.9

用法

胶囊

variant 默认为 capsules,每行一张卡片;用 v-model:open-ids 持有展开集合。

Loading demo...

列表

variant="list" 把各行装进同一张卡片。

Loading demo...

最佳实践

  • 独立浮在页面上的任务组用 capsules,已在卡片里的面板用 list,避免叠两层容器。
  • 真正的重试按钮放进 trailing 插槽,不要放进行头。
  • amount 放右对齐的数量(「12 家供应商」),明细的 label 写做了什么,meta 放计数或比率。
  • 单次工具调用(入参、日志、结果、重试)用 ToolCallCard,本组件用于多行任务状态。

API 参考

属性

属性名类型默认值说明
rowsTaskRowItem[]—任务行,必填。
variant'capsules' | 'list''capsules'容器形态。
defaultOpenIdsstring[]—交互前展开的 id;绑定 openIds 时忽略。
openIdsstring[]—展开的 id;绑定后由宿主持有,否则由组件持有。
doneTextstring'Completed'done 行的药丸文案。
errorTextstring'Failed'error 行的药丸文案。
runningTextstring—running 行的药丸文案;不传则不显示药丸。
pendingTextstring—pending 行的药丸文案;不传则不显示药丸。

事件

事件名参数说明
toggle(id: string, open: boolean)点击某行时触发,参数为行 id 与切换后的状态。
update:openIds(ids: string[])展开集合变化时触发,支持 v-model:open-ids。

插槽

插槽名作用域参数说明
badge{ row }替换徽章(圆徽或环)。
detail{ row, detail, index }替换单条明细。
trailing{ row }渲染在折叠按钮之外的宿主控件。

类型

TaskRowItem

字段类型说明
idstring行的稳定 id。
labelstring任务名称。
status'pending' | 'running' | 'done' | 'error'任务状态,与 AiToolCallPart.status 一致。
amountstring右对齐的数量,等宽数字不随更新跳宽。
indexnumberpending 与 running 时显示在环内的序号。
statusTextstring本行的药丸文案,优先于各状态的文案 prop。
details{ label, meta? }[]展开后的明细;meta 以等宽数字显示。
retryableboolean失败行显示「正在重试」箭头,默认 true;箭头只是指示,不可点击。

概述

  • 无论是否绑定 openIds,切换都会派发 toggle 与 update:openIds。
  • 每行头部是按钮,aria-controls 指向自己的折叠区;收起时折叠区设 inert,明细移出 Tab 序列。
  • 收起不卸载明细,只把高度收为 0。
  • 减少动态效果时停止圆角形变、旋转与入场,状态照常推进。

技术实现

  • 徽章与药丸以 status 为 key,状态切换时重建元素,入场动画才会重播。
  • 移植自 Beautiful UI(© 2026 Shane Levine,MIT)。
  • 源码:packages/tuffex/packages/components/src/task-rows/。
查看源码
packages/tuffex/packages/components/src/task-rows/index.ts