组件/InsightCards 洞察卡

InsightCards 洞察卡

逐页展示结论、证据与追问的洞察卡

Verified自 0.3.9

用法

完整案例

组件只负责标题、翻页、结论与追问;卡片内容由默认插槽提供,如 TxSparkChart、TxChartScrubber、TxAllocationBar。

Loading demo...

指标块

value 走默认格式化时,负号是 U+2212(−),在 tabular-nums 下与数字对齐。

Loading demo...

最佳实践

  • 一页只讲一件事:一句结论、一张证据卡、一个可执行的追问。
  • 结论里的实体提及与行内数字走 prose 插槽;page.prose 只收纯文本。
  • 卡片内容自己控高,否则翻页时页面会随内容跳动。
  • 在插槽里给卡片加 :key="page.key",翻页时才会重建,图表才会重绘。
  • 追问写成用户会问的原话,而不是「了解更多」。

API 参考

TxInsightCards

属性

属性名类型默认值说明
pagesInsightPage[]—页数据 { key, prose?, suggestion? }。
activeIndexnumber—当前页,越界时夹回有效范围;省略则组件自持。
titlestring'Insights'头部标题。
showCountbooleantrue在标题旁显示总页数。
loopbooleantrue首尾环绕;关闭后两端按钮禁用。
previousLabel / nextLabelstring'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

属性

属性名类型默认值说明
labelstring—标签文案。
colorstring—标签前的色点;不传则不渲染。
valuenumber—带符号的大数,走默认格式化。
deltastring—预格式化的大数,原样输出,优先于 value。
unitstring'%'默认格式化追加的单位。
precisionnumber2默认格式化的小数位。
detailstring—等宽副行,原样输出;负号由宿主写成 −。
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