RecommendationCard 建议卡
带置信度的智能体建议卡
用法
建议与备选
在抽屉里选中一条备选,会把它提升为当前建议、关闭抽屉,并清空已确认态。
Loading demo...
最佳实践
short写成能独立读懂的一句话:抽屉里只显示它。- 高风险动作用
ctaTone: 'danger',让主按钮的分量与后果相称。 - 把
accepted提到宿主,请求成功后再置为true,否则用户会以为已经下单。 - 备选控制在两三条;更多时改用列表页。
- 二元的允许 / 拒绝用
TxToolConfirmation;本组件用于带置信度的多选建议。
API 参考
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
title | string | — | 卡片标题,通常是一句待确认的问句,必填。 |
options | RecommendationOption[] | — | 方案列表,必填:{ key, text?, short, confidence?, signal?, tone?, label, cta?, ctaTone? }。 |
modelValue | string | 首项的 key | 当前建议的 key,配合 v-model。 |
open | boolean | — | 备选抽屉,配合 v-model:open;不传则组件自持。 |
accepted | boolean | — | 是否已确认,配合 v-model:accepted;只切换文案与配色,没有撤销。 |
alternativesLabel | string | 'Alternatives' | 抽屉触发按钮的文案。 |
otherOptionsLabel | string | 'Other options' | 抽屉内的小标题。 |
acceptedLabel | string | 'Accepted' | 确认后的主按钮文案。 |
acceptLabel | string | 'Accept' | 方案没有 cta 时的主按钮文案。 |
事件
| 事件名 | 参数 | 说明 |
|---|---|---|
update:modelValue | (key: string) | 当前建议变化时触发。 |
update:open | (open: boolean) | 抽屉开合时触发。 |
update:accepted | (accepted: boolean) | 确认态变化时触发。 |
accept | (option: RecommendationOption) | 按下主按钮时触发,携带完整方案。 |
select | (option: RecommendationOption) | 在抽屉里选中备选时触发。 |
插槽
| 插槽名 | 作用域参数 | 说明 |
|---|---|---|
body | { option } | 替换正文;<code> 放标识符,<mark> 放实体。 |
meter | { option } | 替换量表,页脚与抽屉每行都会用到。 |
footer-extra | — | 插在页脚左侧、动作按钮之前。 |
置信度映射
confidence | 量表格数 | 默认颜色 |
|---|---|---|
high | 3 | --tx-bui-green |
medium | 2 | --tx-bui-orange |
low | 1 | --tx-bui-red |
none(默认) | 0 | --tx-bui-ink-3 |
signal 与 tone 分别覆盖格数与颜色;tone 是裸 CSS 颜色,不随主题切换,优先用 confidence。
概述
- 抽屉只列其他方案,当前建议不会重复出现。
- 收起的抽屉带
inert,其中的按钮移出焦点顺序与无障碍树。 - 正文有最小高度(默认 48px),切换不同长度的方案时卡片不跳动;用
--tx-bui-recommendation-card-body-min-height调整。 body里的<code>渲染为强调色标识符,is-success/is-warning切换为语义色;<mark>渲染为带色点的实体胶囊,色点取--tx-entity-color,缺省为中性灰。
技术实现
- 页脚与抽屉每行的量表是
TxSignalMeter,可单独使用。 - 移植自 Beautiful UI(© 2026 Shane Levine,MIT)。
- 源码:
packages/tuffex/packages/components/src/recommendation-card/。
查看源码
packages/tuffex/packages/components/src/recommendation-card/index.ts