组件/CellLink 单元格链接

CellLink 单元格链接

表格单元格中由宿主决定如何打开的链接

Verified自 0.3.9

用法

基础

underline 选择常驻或悬停下划线;点击只派发 open,不跳转。

Loading demo...

最佳实践

  • 文案是裸域名时补 ariaLabel,如「打开 Aurora Scoops 官网」。
  • 记录名列用 muted 加 underline="hover";专门的链接列用默认色加 underline="always"。
  • 在 Electron 渲染进程中,把 open 交给宿主的外部浏览器通道,不在渲染进程内开窗。
  • 没有链接的单元格渲染占位符(如 —),不渲染 href 为空的 TxCellLink。

API 参考

属性

属性名类型默认值说明
hrefstring-目标地址,写入真实的 href。
labelstringhref显示文案;缺省时显示 href。
externalbooleanfalse追加外链箭头。
mutedbooleanfalse用次级墨色代替链接色,用于记录名列。
underline'always' | 'hover''hover'hover 仅悬停与聚焦时显示;always 常驻淡化下划线。
ariaLabelstring-可见文案说不清去向时的可访问名称。

事件

事件名参数说明
open({ href, event })点击时触发;已调用 preventDefault(),由宿主导航。

插槽

名称说明
default替换链接文案。

概述

  • 渲染原生 <a href>:复制链接、悬停预览、右键菜单照常可用;Enter 同样触发 open。
  • 从不自行导航:在 Electron 渲染进程中,自行跳转会把应用窗口导航走。约定与 TxSources 一致。
  • 外链箭头带 aria-hidden;去向信息写进 ariaLabel。
  • 文案过长时以省略号截断,不撑破单元格。

技术实现

  • 源码:packages/tuffex/packages/components/src/cell-link/。
  • 移植自 Beautiful UI(© 2026 Shane Levine,MIT);上游直接导航,此处改为派发 open。
查看源码
packages/tuffex/packages/components/src/cell-link/index.ts