@gemeente-denhaag/file

中文文档
2.7.0发布于 2026/11/09EUPL-1.2TypeScriptESM + CJS构建来源已验证近 30 天下载 1.2万

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

中文使用文档
文档目录15 节
  1. 何时使用
  2. 替代品和相关构成部分
  3. 解剖学
  4. (互动)状态
  5. 设计属性
  6. 类型
  7. 颜色
  8. 交互式状态
  9. 结构
  10. 无障碍
  11. 内容准则
  12. 最佳做法
  13. 编号
  14. 不要这样
  15. 参考资料

文件

npm version

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

何时使用

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

无.

解剖学

文件包括:

  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/组件/下行负荷/

版本与发布记录

@gemeente-denhaag/file 共发布 121 个版本,首次发布于 2023/09/07;过去 12 个月发布了 12 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.7.0latest2026/11/096 天前
2.6.02026/10/051 个月前
2.5.32026/09/231 个月前
2.5.22026/08/272 个月前
2.5.12026/07/273 个月前
2.5.02026/06/294 个月前

关于 @gemeente-denhaag/file 的常见问题

@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 和提交记录判断。