组件/ApprovalCard 澄清问卷卡

ApprovalCard 澄清问卷卡

智能体动手前逐题澄清的问卷卡

Verified自 0.3.9

用法

多题走查

一次显示一题,单选作答后经 autoAdvanceDelay 自动翻页,多选则等用户按发送键。

Loading demo...

最佳实践

  • 这是问卷,不是授权闸门;单次工具调用的允许或拒绝用 ToolConfirmation。
  • 监听 answer 增量保存,不要只等 submit:用户中途关闭时,已答内容不应丢失。
  • 题目控制在 3~5 个,更多时改用表单页。
  • 非英文界面一并覆盖全部文案 props,避免中英混排。
  • 卡片可能被重建时(如流式消息),由宿主持有答案、index 与 sent。

API 参考

属性

属性名类型默认值说明
questionsApprovalQuestion[]—题目列表,必填。
modelValueRecord<string, ApprovalAnswer>—按 question.id 索引的答案表;不传则组件自持。
indexnumber—当前题号,配合 v-model:index;不传则组件自持。
sentboolean—是否已提交,配合 v-model:sent。
openboolean—配合 v-model:open;为 false 时整卡收成一颗重开按钮。
autoAdvancebooleantrue单选作答后自动翻页;减少动态效果时不生效。
autoAdvanceDelaynumber480自动翻页的延时(ms)。
dismissiblebooleantrue渲染关闭按钮。
ariaLabelstring'Approval questions'整卡的无障碍名称。
sendLabelstring'Send answers'末题发送键的无障碍名称。
nextQuestionLabelstring'Next question'其他题发送键的无障碍名称。
prevLabel / nextLabelstring'Previous' / 'Next'分页箭头的无障碍名称。
dismissLabelstring'Dismiss'关闭按钮的无障碍名称。
reopenLabelstring'Open approval'收起后按钮的文案。
sentLabelstring'Answers sent'提交成功的文案。
startOverLabelstring'Start over'重新开始按钮的文案。
customPlaceholderstring'Type something…'自由作答框的占位,可被单题覆盖。
customLabelstring'Custom answer'自由作答框的无障碍名称。
pagerLabelFormatter(position: number) => stringn => `Go to question ${n}`分页圆点的无障碍名称。
skippablebooleanfalse渲染跳过控件;默认关闭,必答的问卷不该提供出口。
skipLabelstring'Skip'跳过控件的文案。

事件

事件名参数说明
update:modelValue(answers: Record<string, ApprovalAnswer>)答案表变化时触发。
update:index(index: number)翻页时触发。
update:sent(sent: boolean)提交态变化时触发。
update:open(open: boolean)收起或展开时触发。
answer(answer: ApprovalAnswer)每题作答后立即触发,便于增量保存。
submit(answers: ApprovalAnswer[])提交时触发,按 questions 顺序给出已答项。
skip({ questionId, index })跳过当前题时触发;不写入答案,宿主可区分拒答与作答。
dismiss()卡片关闭时触发。
reopen()卡片重新展开时触发。

插槽

插槽名作用域参数说明
question{ question, index }替换题干。
sent{ answers }替换提交成功面板。
footer-extra—插在页脚发送键之前。

暴露方法

方法说明
next() / prev() / goTo(index)翻页。
submit()等同按下发送键;没有答案时不执行。
reset()清空答案、回到首题、退出提交态并重新展开。

类型

ApprovalQuestion

字段类型说明
idstring题目 id,也是答案表的键。
questionstring题干。
type'radio' | 'check'单选或多选,默认 'radio'。
optionsApprovalOption[]选项 { value, label };答案按 value 存储,选项重排不会错位。
allowCustomboolean设为 false 去掉自由作答行,默认 true。
customPlaceholderstring覆盖本题的 customPlaceholder。

ApprovalAnswer

字段类型说明
questionIdstring所属题目的 id。
valuesstring[]选中的 option.value;单选题最多一个。
customstring自由作答文本。

概述

  • modelValue、index、sent、open 传入时以 prop 为准,未传时由组件自持。
  • 单选题上,选项与自由作答互斥,后填的清掉先填的;多选题两者并存。
  • 有选中项或非空自由文本时发送键才可用:末题提交,其余题前进。末题上的自动翻页与跳过同样直接提交。
  • 圆点填满表示该题已作答,与是否经过无关。
  • 关闭后整卡换成重开按钮,状态保留;只有 reset() 或「重新开始」会清空。
  • 选项是带 aria-pressed 的 button,整组为 role="group",以 aria-labelledby 指向题干。

技术实现

  • 移植自 Beautiful UI(© 2026 Shane Levine,MIT)。
  • 源码:packages/tuffex/packages/components/src/approval-card/。
查看源码
packages/tuffex/packages/components/src/approval-card/index.ts