InlineCitation 行内引用
嵌在正文中的来源引用胶囊
用法
基础
Loading demo...
流式回答
引用随正文流入时播放弹入;整段编排由宿主完成,组件只渲染一枚胶囊。
逐词显影 + 行内引用 + 来源 + 追问
Loading demo...
最佳实践
- 监听
open,否则点击引用没有任何反应。 - 每段正文的引用控制在 2~3 枚;密集出现会把段落读成列表。
label通常留空:域名回落让读者一眼看出出处。- 流式场景里
source.id保持稳定,坏图标不会随节点复用反复重试。 - 答案末尾的来源清单用
TxSources;二者共用AiSourceItem,常一起出现。
API 参考
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
source | AiSourceItem | — | 引用目标 { id, url, title?, favicon? },必填。 |
label | string | — | 胶囊文案;缺省时依次取 source.title、去掉 www. 的域名,url 无法解析时用原文。 |
appear | boolean | true | 挂载时播放弹入;重渲染已定稿的答案时设为 false。 |
事件
| 事件名 | 参数 | 说明 |
|---|---|---|
open | (source: AiSourceItem) | 点击时触发;默认跳转已阻止,导航由宿主完成。 |
插槽
| 插槽名 | 作用域参数 | 说明 |
|---|---|---|
default | { source, label } | 替换胶囊文案,可放富文本。 |
icon | { source } | 替换前置的站点图标。 |
概述
- 渲染真实的
<a href>,点击时preventDefault()再派发open,不会把 Electron 渲染进程导航走;浏览器的「在新标签页打开」「复制链接地址」仍可用。 - 站点图标加载失败后不再渲染,胶囊退化为纯文案。
- 图标带
alt=""与aria-hidden,可访问名称来自胶囊文案。 - 胶囊嵌在文字流中,行高由所在段落决定。
- 弹入在挂载时播放一次;
appear由false改为true时会重播。
技术实现
- 移植自 Beautiful UI(© 2026 Shane Levine,MIT)。
- 源码:
packages/tuffex/packages/components/src/inline-citation/。
查看源码
packages/tuffex/packages/components/src/inline-citation/index.ts