卡片依次浮现,来源胶囊稍后出现;节奏由 staggerStep、chipDelay 与 chipStaggerStep 控制。
TxContextChunk 单独渲染一张卡片,供宿主自行排版列表;单独使用时通常关闭 appear。
<TxContextChunk :chunk="chunk" :appear="false" @open="openSource" />
total 传语料库规模,chunks 传本次命中的片段,让「32 条里选了 2 条」一眼可见。chars 在宿主侧格式化好再传,包括千分位;组件不做数字本地化。- 长列表把
appear 设为 false:十几条以上的逐条浮现会显得拖沓。 tone 按文件格式固定映射(PDF 红、CSV 绿),不要按卡片顺序轮换。
| 属性名 | 类型 | 默认值 | 说明 |
|---|
chunks | ContextChunk[] | - | 片段列表。 |
title | string | 'All chunks' | 表头标题。 |
total | number | string | - | 表头计数,表示语料库总量而非 chunks.length;不传则不渲染。 |
appear | boolean | true | 播放入场动画;频繁重渲染的列表应关闭。 |
staggerStep | number | 100 | 卡片之间的入场间隔(ms)。 |
chipDelay | number | 700 | 第一枚来源胶囊的起播延迟(ms)。 |
chipStaggerStep | number | 80 | 来源胶囊之间的错峰(ms)。 |
| 事件名 | 参数 | 说明 |
|---|
open | ContextChunkOpenPayload | 来源行被激活时触发;打开目标由宿主决定。 |
| 插槽名 | Props | 说明 |
|---|
header | - | 替换整个表头。 |
chunk | { chunk, index } | 替换整张卡片。 |
chunk-title / chunk-body / chunk-source | 同 TxContextChunk | 透传给 TxContextChunk 的 title / body / source 插槽。 |
| 属性名 | 类型 | 默认值 | 说明 |
|---|
chunk | ContextChunk | - | 单个片段。 |
appear | boolean | true | 播放入场动画。 |
enterDelay | number | 0 | 卡片浮现延迟(ms,绝对值)。 |
chipDelay | number | 700 | 来源胶囊出现延迟(ms,绝对值)。 |
| 事件名 | 参数 | 说明 |
|---|
open | ContextChunkOpenPayload | 来源行被激活时触发。 |
| 插槽名 | 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