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 🙏

© 2024 – Pkg Stats / Ryan Hefner

@gemeente-denhaag/action

v0.1.2

Published

Action component to navigate to different pages

Downloads

1,079

Readme

Action

npm (scoped) GitHub Workflow Status (branch)

Een task is een interactief element dat je navigeert naar een andere pagina en als doel heeft om een actie uit te voeren.

When to use

Een task is een interactief element dat je navigeert naar een andere pagina en als doel heeft om een actie uit te voeren.

When not to use

Een task is een interactief element dat je navigeert naar een andere pagina en als doel heeft om een actie uit te voeren.

Alternatives and related components

  • Link: Gebruik een link wanneer de gewenste actie is om de gebruiker naar een nieuwe pagina te leiden.
  • Button: Gebruik een button om acties door te geven die gebruikers kunnen ondernemen en om interactie met de pagina mogelijk te maken.

Anatomy

Een task bestaat uit:

  1. Leading icon (optional): biedt ondersteuning bij de bevestiging.
  2. Label: communiceert de taak die je gaat uitvoeren.
  3. Subtext: biedt ondersteuning aan de label.
  4. Deadline icon (optional): geeft weer dat er een waarschuwing is waar je op moet letten.
  5. Date: communiceert de deadline van de taak.
  6. Trailing icon: laat zien dat je ergens naartoe navigeert als je interacteert met de taak.
  7. Secondary button: toont de actie die zal worden uitgevoerd wanneer de gebruiker ermee communiceert.
  8. Primary button: toont de actie die zal worden uitgevoerd wanneer de gebruiker ermee communiceert.
  9. Container

Staten

De task bevat de staten:

  • default
  • hover
  • checked
  • focus

Design properties

Typography

  • Label: TheSans/md/700
  • Subtext: TheSans/md/400
  • Date:
    • Default: TheSans/md/400
    • Deadline: TheSans/md/700

Colors

Default:

  • Label: text color Grey/5
  • Subtext: text color Grey/4
  • Deadline icon: svg color Orange/4
  • Date:
  • Default: text color Grey/4
  • Deadline: text color Orange/5
  • Trailing icon: svg color Blue/3
  • Buttons: zoals beschreven staat bij het component Buttons.
  • Container: border color Grey/2

Hover:

  • Overview:
    • Container: background-color Warm/grey
  • Detail:
    • Buttons: zoals beschreven staat bij het component Buttons.

Focus:

  • Overview:
    • Container: border color Ocher/5
  • Detail:
    • Buttons: zoals beschreven staat bij het component Buttons.

Best practices

Do's

  • Gebruik pictogrammen en kleuren die gemakkelijk te begrijpen zijn. Gebruik een vinkje om voltooide taken aan te geven en een deadline icoon om achterstallige taken aan te geven.
  • Zorg ervoor dat de taak responsief is en goed werkt op verschillende schermformaten en apparaten.
  • Zorg voor duidelijke en beschrijvende labels en gebruik contrastrijke kleuren.
  • Wanneer een taak is voltooid, animeer dan de bevestiging in de oude taak. De oude taak blijft dus in eerste instantie staan en wordt vervangen door de bevestiging.

Don'ts

  • Gebruik geen kleur als enige manier om informatie over te brengen, zoals bij het markeren van de deadline. Dit kan problematisch zijn voor gebruikers die kleurenblind zijn of die kleuren niet goed kunnen onderscheiden.
  • Vermijd het gebruik van kleurencombinaties die onvoldoende contrast bieden en daardoor moeilijk leesbaar zijn voor gebruikers met een visuele beperking.
  • Gebruik geen verwarrende, onduidelijke of dubbelzinnige labels voor de elementen van de taak. Zorg ervoor dat de labels duidelijk en beknopt zijn, zodat gebruikers de functie van elk element gemakkelijk kunnen begrijpen.
  • Verberg geen belangrijke informatie: Verberg geen belangrijke informatie zoals de checked status of prioriteit van een taak en iconen die mogelijk niet toegankelijk zijn voor alle gebruikers.
  • Vermijd onnodige animaties of bewegende elementen in de Task-component. Dit kan afleidend zijn en kan gebruikers afleiden van hun taak of de toegankelijkheid verminderen voor gebruikers met een visuele of cognitieve beperking.

Content guidelines

Label:

  • Gebruik labels die gemakkelijk te begrijpen zijn en de taak duidelijk omschrijven.
  • Gebruik bijvoorbeeld in plaats van 'Taak 1' als label 'Verleng uw identiteitskaart’.
  • Start de label van een taak die je moet uitvoeren altijd met een werkwoord in gebiedende wijs, gevolgd door een zaak/productnaam. Bijvoorbeeld: ‘Geef informatie voor uw aanvraag subsidie geluidsisolatie’.

Button: De buttons moeten in de vorm ‘Infinitief (onbepaalde wijs)’ worden geschreven. Bijvoorbeeld: ‘Betalen’, ‘Informatie geven’ en ‘Negeren’.

Subtext: De subtext moet altijd gelijk zijn wanneer een taak succesvol is uitgevoerd.

Datum:

  • Communiceer datums op de volgende manier: ‘vóór [dag] [maand] [jaar]’. Bijvoorbeeld: ‘vóór 1 mei 2023’.

  • Als een taak binnen 2 dagen moet uitgevoerd, maak je gebruik van de deadline variant. De datum communiceer je op de volgende manier:

    • nog 2 dagen
    • nog 1 dag
    • vandaag

Accessibility

Gebruik semantische HTML-tags om de taakcomponent te structureren, zoals , en . Dit maakt het voor schermlezers en andere ondersteunende technologieën gemakkelijker om het doel van de component te begrijpen.

Gebruik contrastrijke kleuren voor tekst en achtergronden om ervoor te zorgen dat de taakcomponent gemakkelijk leesbaar is voor gebruikers met visuele beperkingen. Test het onderdeel met een kleurcontrastcontrole om er zeker van te zijn dat het voldoet aan de toegankelijkheidsrichtlijnen.

Zorg ervoor dat alle functionaliteit binnen de taakcomponent toegankelijk is via een toetsenbord. Gebruikers die geen muis kunnen gebruiken, vertrouwen op toetsenbordnavigatie voor interactie met webpagina's.

Test met hulptechnologieën: test de taakcomponent met behulp van schermlezers en andere hulptechnologieën om ervoor te zorgen dat deze bruikbaar is voor gebruikers met een handicap.