组件/InlineCitation 行内引用

InlineCitation 行内引用

嵌在正文中的来源引用胶囊

Verified自 0.3.9

用法

基础

Loading demo...

流式回答

引用随正文流入时播放弹入;整段编排由宿主完成,组件只渲染一枚胶囊。

逐词显影 + 行内引用 + 来源 + 追问

Loading demo...

最佳实践

  • 监听 open,否则点击引用没有任何反应。
  • 每段正文的引用控制在 2~3 枚;密集出现会把段落读成列表。
  • label 通常留空:域名回落让读者一眼看出出处。
  • 流式场景里 source.id 保持稳定,坏图标不会随节点复用反复重试。
  • 答案末尾的来源清单用 TxSources;二者共用 AiSourceItem,常一起出现。

API 参考

属性

属性名类型默认值说明
sourceAiSourceItem—引用目标 { id, url, title?, favicon? },必填。
labelstring—胶囊文案;缺省时依次取 source.title、去掉 www. 的域名,url 无法解析时用原文。
appearbooleantrue挂载时播放弹入;重渲染已定稿的答案时设为 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