@gemeente-denhaag/action

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

Action component to navigate to different pages

原始使用文档
文档目录11 节
  1. When to use
  2. When not to use
  3. Alternatives and related components
  4. Anatomy
  5. Staten
  6. Design properties
  7. Best practices
  8. Do's
  9. Don'ts
  10. Content guidelines
  11. Accessibility

Action

npm version 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.

  • 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. In de React-implementatie wordt dit gerenderd via de indicator prop op ActionSingle. De prop accepteert elk React-element, bijvoorbeeld een CheckedIcon uit @gemeente-denhaag/icons bij een afgeronde taak. Het component schrijft geen vaste set statussen voor; de implementatie bepaalt zelf welk icoon bij welke status hoort. Wanneer indicator aanwezig is, wordt automatisch ruimte gereserveerd in de layout en schuift de datum/context-sectie op zodat deze uitlijnt onder de label-tekst — ook op smalle schermen. Wanneer geen indicator wordt meegegeven, valt de layout terug op het standaardgedrag zonder inspringing.
  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

De checked status wordt niet automatisch afgeleid door het component; de implementatie geeft zelf aan of een taak is afgerond door een geschikt icoon (bijvoorbeeld CheckedIcon) mee te geven via de indicator prop. Wanneer geen indicator wordt meegegeven, wordt er geen leading icon getoond en valt de layout terug op het standaardgedrag zonder inspringing.

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
  • Leading icon: svg color Blue/3 (standaardwaarde; via design tokens per implementatie aan te passen, bijvoorbeeld naar een groene kleur om een afgeronde status te benadrukken)
  • 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 <form>, <label> en <input>. 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.

Het leading icon (bijvoorbeeld een vinkje bij een afgeronde taak) mag nooit de enige indicatie van status zijn. Zorg dat de status ook op een andere manier kenbaar wordt gemaakt, bijvoorbeeld via tekst (zoals het label "Afgerond" in eventueel bovenliggende tabs) of via een aria-label/visueel verborgen tekst op het icoon zelf, zodat schermlezergebruikers de status ook meekrijgen.

版本与发布记录

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

版本发布日期距今
4.4.4latest2026/11/096 天前
4.4.32026/10/051 个月前
4.4.22026/09/231 个月前
4.4.12026/08/272 个月前
4.4.02026/07/273 个月前
4.3.02026/06/294 个月前

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

@gemeente-denhaag/action 是什么?

Action component to navigate to different pages

如何安装 @gemeente-denhaag/action?

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

@gemeente-denhaag/action 支持 TypeScript 吗?

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

@gemeente-denhaag/action 支持 ESM 还是 CommonJS?

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

@gemeente-denhaag/action 可以商用吗?

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

@gemeente-denhaag/action 的下载量有多少?

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

@gemeente-denhaag/action 还在维护吗?

最新版本 4.4.4 发布于 2026/11/09(6 天前);至今共发布 120 个版本,其中过去 12 个月发布了 12 个;首次发布于 2023/09/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。