文件

文件显示下载附件的链接并显示文件的元数据.
何时使用
文件用于显示和下载由用户或员工上传的文件.
无.
解剖学
文件包括:
- 文件名: 文件名称
- 预览: 显示文件类型的图标( 如文档, 图像)
- 导航链接: 显示下载选项
- 集装箱
(互动)状态
文件包含状态正常,徘徊和焦点.
设计属性
类型
颜色
- 文件名: 文本颜色 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 的常见问题
@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 和提交记录判断。