组件/ContextCards 检索片段卡

ContextCards 检索片段卡

RAG 检索片段及其来源的卡片列表

Verified自 0.3.9

用法

基础

卡片依次浮现,来源胶囊稍后出现;节奏由 staggerStep、chipDelay 与 chipStaggerStep 控制。

Loading demo...

单块

TxContextChunk 单独渲染一张卡片,供宿主自行排版列表;单独使用时通常关闭 appear。

<TxContextChunk :chunk="chunk" :appear="false" @open="openSource" />

最佳实践

  • total 传语料库规模,chunks 传本次命中的片段,让「32 条里选了 2 条」一眼可见。
  • chars 在宿主侧格式化好再传,包括千分位;组件不做数字本地化。
  • 长列表把 appear 设为 false:十几条以上的逐条浮现会显得拖沓。
  • tone 按文件格式固定映射(PDF 红、CSV 绿),不要按卡片顺序轮换。

API 参考

TxContextCards

属性

属性名类型默认值说明
chunksContextChunk[]-片段列表。
titlestring'All chunks'表头标题。
totalnumber | string-表头计数,表示语料库总量而非 chunks.length;不传则不渲染。
appearbooleantrue播放入场动画;频繁重渲染的列表应关闭。
staggerStepnumber100卡片之间的入场间隔(ms)。
chipDelaynumber700第一枚来源胶囊的起播延迟(ms)。
chipStaggerStepnumber80来源胶囊之间的错峰(ms)。

事件

事件名参数说明
openContextChunkOpenPayload来源行被激活时触发;打开目标由宿主决定。

插槽

插槽名Props说明
header-替换整个表头。
chunk{ chunk, index }替换整张卡片。
chunk-title / chunk-body / chunk-source同 TxContextChunk透传给 TxContextChunk 的 title / body / source 插槽。

TxContextChunk

属性

属性名类型默认值说明
chunkContextChunk-单个片段。
appearbooleantrue播放入场动画。
enterDelaynumber0卡片浮现延迟(ms,绝对值)。
chipDelaynumber700来源胶囊出现延迟(ms,绝对值)。

事件

事件名参数说明
openContextChunkOpenPayload来源行被激活时触发。

插槽

插槽名Props说明
title{ chunk }替换标题文本。
body{ chunk }替换正文。
source{ chunk, source }替换整行来源。

类型

名称说明
ContextChunk{ id, title, body?, chars?, source? };chars 是已格式化的字符串,如 290 characters。
ContextChunkSource{ name, badge?, tone?, href? };tone 复用 IconChipTone。
ContextChunkOpenPayload{ chunk, source }。

概述

  • 来源带 href 时渲染为 <a> 并保留 href,点击时 preventDefault() 再派发 open,与 TxSources 一致;没有 href 时是静态 <span>,没有悬停反馈。
  • 挂载后才追加的片段不参与错峰,不会按索引空等。
  • 减弱动效时延迟清零,来源胶囊立即可见。
  • 入场只在元素创建时播放;重放需要重新挂载(换 key)。

技术实现

  • 子件只以 TxContextChunk 导出,没有无前缀别名:ContextChunk 是数据类型的名字。
  • 移植自 Beautiful UI(© 2026 Shane Levine,MIT)。
  • 源码:packages/tuffex/packages/components/src/context-cards/。
查看源码
packages/tuffex/packages/components/src/context-cards/index.ts