组件/Sources

Sources

可折叠的引用来源列表

Verified自 0.3.9

用法

基础

Loading demo...

来源堆叠

variant="stack" 用前几条来源的站点图标替换头部的地球图标,折叠时也能看出引用了哪些站点。

流式回答定稿后出现

Loading demo...

最佳实践

  • 监听 open,否则点击引用没有任何反应。
  • 桌面端在外部浏览器打开并带上 noopener,不要把应用窗口导航走。
  • id 用稳定标识:图标失败记录按 id 保存,id 变化会让坏图重新加载。
  • 中文界面覆盖 labelFormatter:默认文案是英文,并按英文单复数变形。

API 参考

属性

属性名类型默认值说明
sourcesAiSourceItem[]—引用列表 { id, url, title?, favicon? },必填。
labelFormatter(count: number) => string—折叠标题;缺省为 Used N source(s)。
defaultOpenbooleanfalse初始是否展开,只在挂载时读取。
variant'default' | 'stack''default'stack 用重叠的站点图标替换头部的地球图标。

事件

事件名参数说明
open(source: AiSourceItem)点击某条引用时触发;默认跳转已阻止,导航由宿主完成。

概述

  • 点击时 preventDefault() 再派发 open;href 仍在 <a> 上,浏览器的「在新标签页打开」「复制链接地址」照常可用。
  • stack 最多取前 3 条能显示图标的来源,一条都没有时回落到地球图标;图标加载失败的来源退出堆叠,由后面的补上。
  • 堆叠图标的描边取 --tx-sources-stack-ring(默认为页面底色);头部不在页面底色上时,改指向所在容器的底色。
  • title 为空时显示去掉 www. 的域名;url 无法解析时显示原文。
  • 同一实例内,图标加载失败会被记下,不再重复请求。
  • 列表是 <ol>,序号来自渲染顺序;图标带 alt="" 与 aria-hidden,可访问名称由标题与域名承载。

技术实现

  • 堆叠图标取前 3 条带图标且未失败的来源;失败记录是实例内以 id 为键的集合。
  • 图标的 error 事件把来源记入该集合,之后该来源不再渲染图标。
  • 源码:packages/tuffex/packages/components/src/sources/。
查看源码
packages/tuffex/packages/components/src/sources/index.ts