npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2025 – Pkg Stats / Ryan Hefner

@gemeente-denhaag/file

v2.2.1

Published

A file displays a link to download an attachment and metadata about the file.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

nl-design-system-cinl-design-system-ciyolijnyolijnmijndenhaagmijndenhaagyourivhdenhaagyourivhdenhaag

Keywords

Readme

File

A file displays a link to download an attachment and shows metadata about the file.

When to use

A file is used to present and download a file that is uploaded by the user or an employee.

Alternatives and related components

None.

Anatomy

The file consists of:

  1. File name: the name of the file
  2. Preview: shows an icon of the type of the file (e.g. document, image)
  3. Navigational link: shows the download option
  4. Container

(Interactive) states

The file contains the states normal, hover and focus.

Design properties

Typography

  • File name: TheSans/md/400

Color

  • File name: text color Grey/4
  • Preview: icon svg color Grey/4, border color Grey/2
  • Container: border color Grey/2

Interactive states

  • Hover: title text color Blue/3, icon svg color Blue/3, container background-color warm/grey
  • Focus: title text color Grey/4, icon svg color Grey/4, container border color Ocher/5

Structure

  • File name: padding-left and padding-right 16px
  • Preview: icon size 24px, icon padding 16px
  • Navigational link: padding-left and padding-right 16px
  • Container: min-height 56px, padding-top and padding-bottom 16px, margin-bottom 16px, border 1px

Mobile

  • File name: padding-bottom 8px, padding-left and padding-right 16px
  • Navigational link: padding-left 16px
  • Preview: icon size 24px, icon padding-left and padding-right 16px
  • Container: padding-top and padding-bottom 12px

Accessibility

In order to comply with accessibility standards you should not force a file to open in a new tab. It must be left up to the user to decide whether to download a file, or open in a new tab.

The one exception to this rule is in forms as there are often challenges around caching user data. When ns-download is used within ns-form; if the browser can display the file type it will open in a new tab.

Content guidelines

None.

Best practices

Dos

Files download should:

  • Be used for all downloads.
  • Include file size and type. Showing the file size is particularly nice for users that are on reduced data allowences (i.e. mobile), and also offers an indication on how long a file might take to download.

Don’ts

Files download should:

  • Not be described as a file.

References

https://ons-design-system.netlify.app/components/downloads/