# @gemeente-denhaag/link 中文文档

规范地址：https://npmcn.com/package/%40gemeente-denhaag/link/

版本：4\.2\.3
npm 元数据更新时间：2026-11-09T14:43:44.353Z
中文译文更新时间：2026-11-16T02:27:07.854Z
软件包许可：EUPL-1\.2

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gemeente-denhaag/link
原文对照：https://npmcn.com/package/%40gemeente-denhaag/link/?lang=original
源码仓库：https://github.com/nl-design-system/denhaag

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：63.2 kB，19 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react 18 \|\| 19，react-dom 18 \|\| 19
- 首次发布：2021-03-20T11:44:33.185Z
- 最新版本发布：2026-11-09T14:43:43.969Z
- 近 30 天下载量：17139（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：437（近 12 个月 5 个）

## 中文简介

链接组件

## 安装

```sh
npm install @gemeente-denhaag/link
```

也可以使用：`pnpm add @gemeente-denhaag/link`、`yarn add @gemeente-denhaag/link`、`bun add @gemeente-denhaag/link`

## README

# 导航链接

[![npm version](https://img.shields.io/npm/v/@gemeente-denhaag/link.svg)](https://www.npmjs.com/package/@gemeente-denhaag/link) ![GitHub Workflow Status (branch)](https://img.shields.io/github/workflow/status/nl-design-system/denhaag/Build%20and%20deploy%20Storybook%20to%20Azure%20Web%20App/main?logo=github&style=flat-square)

[图像设计](https://www.figma.com/file/JpoY3waVoQGlLQzQXTL9nn/Design-System-Gemeente-Den-Haag?node-id=1485%3A1156)

链接被用作导航元素. 它们可能单独出现,在一个句子或一段中,或直接按照内容出现.

## 何时使用

链接作为通航元素使用,可以自行使用,也可以与文本同入. 它们为导航提供了一种轻量级的选择,但与其他交互要素一样,太多的链接会打乱一页,使用户难以确定下一步。 内在链接尤其如此,应谨慎使用.

用户需要时使用链接 :

-   导航到网站内的另一个页面
-   导航到一个完全不同的网站
-   链接到电子邮件或电话号码

## 替代品和相关构成部分

使用 `Button` 与不出现在句子内或直接出现在句子后的行为有关.

[导航到按钮](https://npmcn.com/package/%40gemeente-denhaag/?path=/docs/components-input-button--default)

## 解剖学

导航链路包括:

1.  标签: 通讯正在链接的内容
2.  图标 (可选): 此图标给出标签的额外指导

## (互动)状态

导航链接包含正常状态,徘徊状态,被禁用状态和焦点状态.

## 设计属性

## 类型

-   标签:桑斯人/md/400

### 颜色

-   标签:文字颜色 Blue/3
-   图标: svg 颜色 Blue/3

### 交互式状态

-   Hover: 标签文本颜色 Blue/4, 图标 svg 颜色 Blue/4
-   已禁用: 标签为文字颜色 Grey/2, 图标 svg 颜色 Grey/2
-   焦点:标签文本颜色 Blue/4,图标 svg 颜色 Blue/4,边框颜色 Ocher/5

### 结构

-   标签:上行和下行
-   图标:高度和宽度 20px
-   图标左:贴地-右 8px
-   图标右:贴上-左 8px

## 最佳做法

### 按钮对导航链接

导航链接主要用于导航,通常出现在句子内部或直接后.

按钮主要用于“添加”、“关闭”、“取消”或“拯救”。 与链接相近的平面按钮用于不太重要或不太常用的动作,如"视图设置".

### 说吧

导航链接应当:

-   在可能的情况下,置于刑期的末尾
-   清楚地解释一下链接会带你们到哪里
-   前加载最相关的关键字
-   断章取义

### 别

导航链接应当:

-   永远不要用按钮代替链接
-   链接不使用模糊或通用标签
-   在新标签中不打开内部链接

## 参考资料

[https://www.interaction-design.org/literature/article/tips-for-better-超链接-ux (中文(简体) )](https://www.interaction-design.org/literature/article/tips-for-better-hyperlink-ux)  
[https://blog.prototypr.io/a-guide-to-designing-perfect-links-in-ux-414558f35730 互联网档案馆的存檔,存档日期2014-12-21](https://blog.prototypr.io/a-guide-to-designing-perfect-links-in-ux-414558f35730)  
[https://uxplanet.org/dos-and-don-ts-of-web-design-8c9d6a5de7c6 互联网档案馆的存檔,存档日期2013-12-22](https://uxplanet.org/dos-and-don-ts-of-web-design-8c9d6a5de7c6)  
[https://www.nngroup.com/articles/writing-links/ (中文(中国大陆) )](https://www.nngroup.com/articles/writing-links/)

## 常见问题

### @gemeente-denhaag/link 是什么？

链接组件

### 如何安装 @gemeente-denhaag/link？

在项目目录运行 npm install @gemeente-denhaag/link，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（18 \|\| 19）、react-dom（18 \|\| 19）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gemeente-denhaag/link 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @gemeente-denhaag/link 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @gemeente-denhaag/link 可以商用吗？

@gemeente-denhaag/link 使用 EUPL-1\.2 许可。声明的许可为 EUPL-1\.2，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @gemeente-denhaag/link 的下载量有多少？

根据 npm 官方下载统计，@gemeente-denhaag/link 在 2026/10/16 – 2026/11/14 这 30 天内被下载 17,139 次，日均约 571 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gemeente-denhaag/link 还在维护吗？

最新版本 4\.2\.3 发布于 2026/11/09（6 天前）；至今共发布 437 个版本，其中过去 12 个月发布了 5 个；首次发布于 2021/03/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

