diff --git a/packages/css/src/components/card/README.md b/packages/css/src/components/card/README.md index 8a27c83d55..f5a398fc4e 100644 --- a/packages/css/src/components/card/README.md +++ b/packages/css/src/components/card/README.md @@ -1,12 +1,25 @@ # Card -Gebruik een card op een overzichtspagina om te verwijzen naar een detailpagina, zoals een nieuwsbericht, een vacature of een zoekresultaat. De card bevat meestal de titel, introductie en afbeelding van de content. De link is verplicht. +Gebruik een card op een overzichtspagina om te verwijzen naar een detailpagina, +zoals een nieuwsbericht, een vacature of een zoekresultaat. +De card bevat meestal de titel, introductie en afbeelding van de content. +De link is verplicht. -## Schermlezers +## Richtlijnen -Met een schermlezer kun je onder andere navigeren via headings en links in een document. De titel van een card is een link in een heading, zodat je van beide navigatiemanieren gebruik kunt maken. Een schermlezer leest eerst de titel op, daarna de rest van de inhoud. +- De titel van een card is een link in een heading. + Hier gelden dezelfde richtlijnen voor als voor reguliere [links](?path=/docs/react_navigation-link--docs) en [headings](?path=/docs/react_text-heading--docs). + De link is actief op het hele gebied van de card. +- Een card heeft meer inhoud nodig dan alleen een titel. + Vul dit aan met tekstuele en/of visuele inhoud. +- De tekst zet je in een reguliere paragraaf. + Alleen voor een tagline of datum gebruik je de kleinste tekstgrootte. +- Als de inhoud geen detailpagina vertegenwoordigt is dit component niet de beste optie. + Om te verwijzen naar een thematische pagina gebruik je een [top task link](?path=/docs/react_navigation-top-task-link--docs). + Ook kun je een [reguliere link](?path=/docs/react_navigation-link--docs) inzetten. -## Richtlijnen +## Schermlezers -- De titel van een card is een link in een heading. Hier gelden dezelfde richtlijnen voor als voor reguliere [links](https://amsterdam.github.io/design-system/?path=/docs/react_navigation-link--docs) en [headings](https://amsterdam.github.io/design-system/?path=/docs/react_text-heading--docs). -- Een card heeft meer inhoud nodig dan alleen een titel. Vul dit aan met tekstuele en/of visuele inhoud. Als dit lastig is, kijk dan of een [top task link](https://amsterdam.github.io/design-system/?path=/docs/react_navigation-top-task-link--docs) of [reguliere link](https://amsterdam.github.io/design-system/?path=/docs/react_navigation-link--docs) beter past. +Met een schermlezer kun je onder andere navigeren via headings en links in een document. +De titel van een card is een link in een heading, zodat je van beide navigatiemanieren gebruik kunt maken. +Een schermlezer leest eerst de titel op, daarna de rest van de inhoud. diff --git a/storybook/storybook-react/src/Card/Card.docs.mdx b/storybook/storybook-react/src/Card/Card.docs.mdx index c185f25a62..1975f29fcf 100644 --- a/storybook/storybook-react/src/Card/Card.docs.mdx +++ b/storybook/storybook-react/src/Card/Card.docs.mdx @@ -10,16 +10,17 @@ import README from "../../../../packages/css/src/components/card/README.md?raw"; -## Card with tagline +## Met tagline -Een card kan een _tagline_ hebben, tekst voor de titel. -Om de volgorde voor schermlezers logisch te houden, -wordt eerst de titel gedefinieerd, en dan de _tagline_. Visueel wordt dit omgedraaid door `Card.HeadingGroup`. +Een card kan boven de titel een _tagline_ tonen, een korte term zoals een categorie of informatiesoort. +Gebruik een `Card.HeadingGroup`. +Dit zorgt er ook voor dat schermlezers eerst de titel voorlezen, dan de tagline. - + -## Image card +## Met afbeelding -Een card kan ook een plaatje bevatten. Gebruik het Aspect Ratio component voor de juiste beeldverhoudingen. +Een card toont vaak de afbeelding van de detailpagina. +Gebruik [Aspect Ratio](?path=/docs/layout-aspect-ratio--docs) voor de juiste beeldverhouding. - + diff --git a/storybook/storybook-react/src/Card/Card.stories.tsx b/storybook/storybook-react/src/Card/Card.stories.tsx index d3bf7e3623..5f0653b590 100644 --- a/storybook/storybook-react/src/Card/Card.stories.tsx +++ b/storybook/storybook-react/src/Card/Card.stories.tsx @@ -6,9 +6,23 @@ import { AspectRatio, Card, Heading, Image, Paragraph } from '@amsterdam/design-system-react' import { Meta, StoryObj } from '@storybook/react' +const dateFormat = new Intl.DateTimeFormat('nl', { + day: 'numeric', + month: 'long', + year: 'numeric', +}) +const today = dateFormat.format(Date.now()) + const meta = { - title: 'Containers/Card', + title: 'Navigation/Card', component: Card, + decorators: [ + (Story) => ( +
+ +
+ ), + ], } satisfies Meta export default meta @@ -21,21 +35,14 @@ export const Default: Story = { Monitor Attracties MRA , - + Ontwikkeling van het aantal attracties en bezoekers in de metropoolregio Amsterdam. , ], }, - decorators: [ - (Story) => ( -
- -
- ), - ], } -export const CardWithTagline: Story = { +export const WithTagline: Story = { args: { children: [ @@ -46,14 +53,11 @@ export const CardWithTagline: Story = { Ontwikkeling van het aantal attracties en bezoekers in de metropoolregio Amsterdam. , - - Laatst gewijzigd: 28 september 2023 - , ], }, } -export const ImageCard: Story = { +export const WithImage: Story = { args: { children: [ @@ -64,16 +68,12 @@ export const ImageCard: Story = { Monitor Attracties MRA , - + Ontwikkeling van het aantal attracties en bezoekers in de metropoolregio Amsterdam. , + + {today} + , ], }, - decorators: [ - (Story) => ( -
- -
- ), - ], }