# @gemeente-denhaag/file 中文文档

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

版本：2\.7\.0
npm 元数据更新时间：2026-11-09T14:43:44.913Z
中文译文更新时间：2026-11-16T02:26:48.461Z
软件包许可：EUPL-1\.2

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

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

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

- 包体积（解压后）：32.4 kB，17 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：react 18 \|\| 19，react-dom 18 \|\| 19
- 首次发布：2023-09-07T09:19:39.263Z
- 最新版本发布：2026-11-09T14:43:44.414Z
- 近 30 天下载量：12480（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：121（近 12 个月 12 个）

## 中文简介

文件会显示下载文件附件和元数据的链接 .

## 安装

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

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

## README

# 文件

[![npm version](https://img.shields.io/npm/v/@gemeente-denhaag/file.svg)](https://www.npmjs.com/package/@gemeente-denhaag/file)

文件显示下载附件的链接并显示文件的元数据.

## 何时使用

文件用于显示和下载由用户或员工上传的文件.

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

无.

## 解剖学

文件包括:

1.  文件名: 文件名称
2.  预览: 显示文件类型的图标( 如文档, 图像)
3.  导航链接: 显示下载选项
4.  集装箱

## (互动)状态

文件包含状态正常,徘徊和焦点.

## 设计属性

### 类型

-   文件名: The Sans/md/400

### 颜色

-   文件名: 文本颜色 Grey/4
-   预览:图标 svg 颜色 Grey/4, 边框颜色 Grey/2
-   容器:边框颜色为灰色/2

### 交互式状态

-   Hover:标题文本颜色为 " Blue/3 " ;图标 svg 颜色为 " Blue/3 " ; 集装箱背景-颜色为 " 暖 " / " 灰 "
-   焦点:标题文本颜色 Grey/4,图标 svg 颜色 Grey/4, 容器边框颜色 Ocher/5

### 结构

-   文件名: 左侧和右侧 16px
-   预览: 图标大小 24px, 图标加载 16px
-   导航链接: 左侧和右侧 16px
-   集装箱:小-高56px、上层和下层16px、下边16px、边界1px

#### 移动

-   文件名: 从下到下 8px, 从左到右 16px
-   导航链接: padding-left 16px
-   预览:图标大小为 24px,图标贴上左侧并贴上右侧 16px
-   集装箱:上层和下层

## 无障碍

为了遵守无障碍标准,您不应强制在新标签中打开文件。 必须由用户来决定是下载文件,还是在新的标签中打开.

这一规则的一个例外是形式上,因为对于缓存用户数据往往存在挑战。 当在ns-窗体内使用ns-下载时;如果浏览器可以显示文件类型,它会在一个新的标签中打开.

## 内容准则

无.

## 最佳做法

### 编号

文件下载应当 :

-   用于所有下载.
-   包括文件大小和类型。 显示文件大小对于数据允许度降低(即移动)的用户来说特别不错,并且还提供了文件下载时间的说明.

### 不要这样

文件下载应当 :

-   不描述为文件 .

## 参考资料

[https://ons-design-system.netlify.app/组件/下行负荷/](https://ons-design-system.netlify.app/components/downloads/)

## 常见问题

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

文件会显示下载文件附件和元数据的链接 \.

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

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

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

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

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

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

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

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

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

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

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

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

