Sources
可折叠的引用来源列表
用法
基础
Loading demo...
来源堆叠
variant="stack" 用前几条来源的站点图标替换头部的地球图标,折叠时也能看出引用了哪些站点。
流式回答定稿后出现
Loading demo...
最佳实践
- 监听
open,否则点击引用没有任何反应。 - 桌面端在外部浏览器打开并带上
noopener,不要把应用窗口导航走。 id用稳定标识:图标失败记录按id保存,id变化会让坏图重新加载。- 中文界面覆盖
labelFormatter:默认文案是英文,并按英文单复数变形。
API 参考
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
sources | AiSourceItem[] | — | 引用列表 { id, url, title?, favicon? },必填。 |
labelFormatter | (count: number) => string | — | 折叠标题;缺省为 Used N source(s)。 |
defaultOpen | boolean | false | 初始是否展开,只在挂载时读取。 |
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