---
title: "CellLink 单元格链接"
description: "表格单元格中由宿主决定如何打开的链接"
category: Data
status: beta
since: 0.3.9
tags: [link, table, cell, data]
syncStatus: reviewed
verified: true
---

## 用法

### 基础
`underline` 选择常驻或悬停下划线；点击只派发 `open`，不跳转。
:::TuffDemoWrapper{demo="CellLinkCellLinkDemo" code-lang="vue"}
---
code: |
  <script setup lang="ts">
  function onOpen({ href }) {
    // 组件不导航，宿主决定：网页开新标签，桌面端交给系统浏览器
    window.open(href, '_blank', 'noopener,noreferrer')
  }
  </script>

  <template>
    <TxCellLink href="https://aurora-scoops.example" label="Aurora Scoops" muted @open="onOpen" />
    <TxCellLink href="https://kumo-creamery.example" label="kumo-creamery.example" underline="always" @open="onOpen" />
    <TxCellLink href="https://maple-orbit.example" label="maple-orbit.example" external @open="onOpen" />
  </template>
---
:::

### 最佳实践

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

## API 参考

### 属性

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

### 事件

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

### 插槽

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

## 概述

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

## 技术实现

- 源码：`packages/tuffex/packages/components/src/cell-link/`。
- 移植自 [Beautiful UI](https://www.beautifului.dev)（© 2026 Shane Levine，MIT）；上游直接导航，此处改为派发 `open`。

<TuffDocSourceLink />
