InsightCards 洞察卡
逐页展示结论、证据与追问的洞察卡
用法
完整案例
组件只负责标题、翻页、结论与追问;卡片内容由默认插槽提供,如 TxSparkChart、TxChartScrubber、TxAllocationBar。
Loading demo...
指标块
value 走默认格式化时,负号是 U+2212(−),在 tabular-nums 下与数字对齐。
Loading demo...
最佳实践
- 一页只讲一件事:一句结论、一张证据卡、一个可执行的追问。
- 结论里的实体提及与行内数字走
prose插槽;page.prose只收纯文本。 - 卡片内容自己控高,否则翻页时页面会随内容跳动。
- 在插槽里给卡片加
:key="page.key",翻页时才会重建,图表才会重绘。 - 追问写成用户会问的原话,而不是「了解更多」。
API 参考
TxInsightCards
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
pages | InsightPage[] | — | 页数据 { key, prose?, suggestion? }。 |
activeIndex | number | — | 当前页,越界时夹回有效范围;省略则组件自持。 |
title | string | 'Insights' | 头部标题。 |
showCount | boolean | true | 在标题旁显示总页数。 |
loop | boolean | true | 首尾环绕;关闭后两端按钮禁用。 |
previousLabel / nextLabel | string | 'Previous insight' / 'Next insight' | 翻页按钮的可访问名称。 |
事件
| 事件名 | 回调参数 | 说明 |
|---|---|---|
update:activeIndex | (index: number) | 翻页时触发。 |
change | (page, index) | 与 update:activeIndex 同时触发,带页对象。 |
followUp | (page) | 点击追问 pill 时触发。 |
插槽
| 插槽名 | 作用域参数 | 说明 |
|---|---|---|
default | { page, index } | 卡片主体。 |
prose | { page, index } | 富文本结论,替换 page.prose。 |
follow-up | { page, index } | 替换追问 pill。 |
暴露方法
| 方法名 | 说明 |
|---|---|
previous() / next() / goTo(index) | 命令式翻页,与按钮走同一路径。 |
TxInsightMetric
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
label | string | — | 标签文案。 |
color | string | — | 标签前的色点;不传则不渲染。 |
value | number | — | 带符号的大数,走默认格式化。 |
delta | string | — | 预格式化的大数,原样输出,优先于 value。 |
unit | string | '%' | 默认格式化追加的单位。 |
precision | number | 2 | 默认格式化的小数位。 |
detail | string | — | 等宽副行,原样输出;负号由宿主写成 −。 |
tone | 'positive' | 'negative' | 'neutral' | — | 覆盖由符号推导的色调。 |
formatter | (value: number) => string | — | 完全接管数字格式化。 |
插槽
| 插槽名 | 作用域参数 | 说明 |
|---|---|---|
detail | — | 替换等宽的副行;未插入时渲染 detail 属性。 |
概述
- 不传
activeIndex时组件自己翻页;传入后完全由宿主控制。 - 翻页是硬切,没有过渡,也没有自动播放;需要过渡时把默认插槽的内容包进自己的
<Transition>。 loop关闭时端点按钮带原生disabled;pages为空时只渲染头部,两个按钮都禁用。- 没有
suggestion的页不渲染追问 pill。 TxInsightMetric的色调缺省由符号推导:正为绿,负为红,零为中性。- 大数与页数使用
tabular-nums,翻页时数字宽度不跳。
技术实现
- 移植自 Beautiful UI(© 2026 Shane Levine,MIT)。
- 源码:
packages/tuffex/packages/components/src/insight-cards/。
查看源码
packages/tuffex/packages/components/src/insight-cards/index.ts