Announces manual hero slide changes and adds a pause button
Continuous Integration / check (pull_request) Successful in 59s
Continuous Integration / deploy-test (pull_request) Skipped
Continuous Integration / lighthouse (pull_request) Successful in 3m59s
Continuous Integration / deploy-production (pull_request) Skipped

Screen readers now hear the new photo after an arrow or swipe, while automatic
changes stay silent. A pause button bottom right lets visitors stop the slide
show, which hover and keyboard focus alone did not allow on touch screens.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-19 19:31:31 +02:00
co-authored by Claude Opus 5.5
parent 8f0f32261c
commit 46fb2f6b5c
11 changed files with 424 additions and 7 deletions
+72
View File
@@ -53,6 +53,78 @@ describe('Hero', () => {
expect(sources()).toEqual([slide(0), slide(1), slide(2)]);
});
describe('meldingen voor schermlezers', () => {
const announcement = () =>
screen.getByTestId('hero-announcement').textContent;
it('meldt een wissel door de bezoeker met nummer en beschrijving', async () => {
await renderWithProviders(
<Hero content={heroContent} socials={siteContent.socials} />,
);
const region = screen.getByTestId('hero-announcement');
expect(region).toHaveAttribute('aria-live', 'polite');
expect(announcement()).toBe('');
await userEvent.click(
screen.getByRole('button', { name: 'Volgende foto' }),
);
expect(announcement()).toBe(
`Foto 2 van ${heroContent.slides.length}: ${heroContent.slides[1].alt}`,
);
await userEvent.click(
screen.getByRole('button', { name: 'Vorige foto' }),
);
expect(announcement()).toBe(
`Foto 1 van ${heroContent.slides.length}: ${heroContent.slides[0].alt}`,
);
});
// Stil blijven bij een automatische wissel: zie useHeroSlider.test.tsx
// (jsdom kent geen animationend voor React)
});
describe('pauzeknop', () => {
it('pauzeert en hervat de diavoorstelling', async () => {
const { container } = await renderWithProviders(
<Hero content={heroContent} socials={siteContent.socials} />,
);
const pause = screen.getByRole('button', {
name: 'Diavoorstelling pauzeren',
});
const progress = () => screen.getByTestId('hero-progress');
expect(progress()).toHaveAttribute('data-state', 'running');
await userEvent.click(pause);
expect(pause).toHaveAccessibleName('Diavoorstelling afspelen');
expect(progress()).toHaveAttribute('data-state', 'paused');
// Blijft gepauzeerd als de muis de hero verlaat
fireEvent.pointerLeave(container.querySelector('section')!);
expect(progress()).toHaveAttribute('data-state', 'paused');
await userEvent.click(pause);
expect(pause).toHaveAccessibleName('Diavoorstelling pauzeren');
expect(progress()).toHaveAttribute('data-state', 'running');
expect(await axeResults(container)).toHaveNoViolations();
});
it('ontbreekt als er niets automatisch wisselt', async () => {
await renderWithProviders(
<Hero
content={{
...heroContent,
slides: heroContent.slides.slice(0, 1),
}}
socials={siteContent.socials}
/>,
);
expect(
screen.queryByRole('button', { name: /Diavoorstelling/ }),
).not.toBeInTheDocument();
});
});
it('heeft pijlen met een toegankelijke naam', async () => {
await renderWithProviders(
<Hero content={heroContent} socials={siteContent.socials} />,
+41 -4
View File
@@ -1,7 +1,15 @@
import { useState } from 'react';
import { Box, chakra, Container, Heading, Image } from '@chakra-ui/react';
import {
Box,
chakra,
Container,
Heading,
Image,
VisuallyHidden,
} from '@chakra-ui/react';
import LinkButton from '../LinkButton';
import HeroArrows from './HeroArrows';
import HeroPauseButton from './HeroPauseButton';
import HeroSocials from './HeroSocials';
import useHeroSlider from './useHeroSlider';
import type { HeroContent, SocialLink } from '@/content/types';
@@ -16,8 +24,19 @@ type HeroProps = {
export default function Hero({ content, socials }: HeroProps) {
const { title, tagline, cta, slides } = content;
const { active, reducedMotion, autoplay, paused, next, prev, handlers } =
useHeroSlider(slides.length);
const {
active,
announce,
reducedMotion,
autoplay,
paused,
stopped,
toggleStopped,
next,
prev,
advance,
handlers,
} = useHeroSlider(slides.length);
// De slides liggen op elkaar in beeld, dus loading="lazy" stelt niets uit.
// Eerst alleen de actieve foto; zodra die binnen en getekend is (twee
// frames later, dus na de eerste paint) ook de volgende en de vorige.
@@ -129,6 +148,22 @@ export default function Hero({ content, socials }: HeroProps) {
{slides.length > 1 && <HeroArrows onPrev={prev} onNext={next} />}
<HeroSocials socials={socials} />
{autoplay && (
<HeroPauseButton stopped={stopped} onToggle={toggleStopped} />
)}
{/* Meldt een wissel door de bezoeker; staat er altijd, want een
live-gebied moet al bestaan voordat de tekst verandert. Leeg na
een automatische wissel, zodat er geen oude melding blijft. */}
<VisuallyHidden
aria-live="polite"
aria-atomic="true"
data-testid="hero-announcement"
>
{announce
? `Foto ${active + 1} van ${slides.length}: ${slides[active].alt}`
: ''}
</VisuallyHidden>
{/* Voortgangsbalk: als de animatie klaar is, schuift de slider door.
Door de key start hij opnieuw bij elke slidewissel. */}
@@ -136,6 +171,8 @@ export default function Hero({ content, socials }: HeroProps) {
<Box
key={active}
aria-hidden
data-testid="hero-progress"
data-state={paused ? 'paused' : 'running'}
position="absolute"
left={0}
bottom={0}
@@ -148,7 +185,7 @@ export default function Hero({ content, socials }: HeroProps) {
animationFillMode="forwards"
animationPlayState={paused ? 'paused' : 'running'}
css={{ '--width': '100%' }}
onAnimationEnd={next}
onAnimationEnd={advance}
/>
)}
</Box>
@@ -0,0 +1,42 @@
import { chakra, useRecipe } from '@chakra-ui/react';
import { Icon } from '@iconify/react/offline';
import caretRightOutlined from '@iconify-icons/ant-design/caret-right-outlined';
import pauseOutlined from '@iconify-icons/ant-design/pause-outlined';
type HeroPauseButtonProps = {
stopped: boolean;
onToggle: () => void;
};
// Rechtsonder, spiegelbeeld van de socials linksonder. De naam wisselt mee
// met de stand (W3C carrouselpatroon), daarom geen aria-pressed.
export default function HeroPauseButton({
stopped,
onToggle,
}: HeroPauseButtonProps) {
const iconControl = useRecipe({ key: 'iconControl' });
return (
<chakra.button
type="button"
aria-label={
stopped
? 'Diavoorstelling afspelen'
: 'Diavoorstelling pauzeren'
}
data-testid="hero-pause-button"
onClick={onToggle}
css={iconControl()}
position="absolute"
right="gutter"
bottom={{ base: 6, md: 10 }}
zIndex={2}
fontSize="1.5rem"
>
<Icon
icon={stopped ? caretRightOutlined : pauseOutlined}
aria-hidden
/>
</chakra.button>
);
}
@@ -0,0 +1,69 @@
import { act, fireEvent, render, renderHook } from '@testing-library/react';
import { describe, expect, it, vi } from 'vitest';
import useHeroSlider from './useHeroSlider';
// De automatische wissel komt in de browser van animationend op de
// voortgangsbalk; jsdom kent geen AnimationEvent, dus hier rechtstreeks.
describe('useHeroSlider', () => {
it('meldt een wissel door de bezoeker, een automatische niet', () => {
const { result } = renderHook(() => useHeroSlider(8));
expect(result.current.announce).toBe(false);
act(() => result.current.next());
expect(result.current).toMatchObject({ active: 1, announce: true });
act(() => result.current.advance());
expect(result.current).toMatchObject({ active: 2, announce: false });
act(() => result.current.prev());
expect(result.current).toMatchObject({ active: 1, announce: true });
});
it('loopt rond aan beide kanten', () => {
const { result } = renderHook(() => useHeroSlider(3));
act(() => result.current.prev());
expect(result.current.active).toBe(2);
act(() => result.current.advance());
expect(result.current.active).toBe(0);
});
it('afspelen via de knop heft ook de pauze door hover op', () => {
let slider!: ReturnType<typeof useHeroSlider>;
function Probe() {
slider = useHeroSlider(8);
return <section data-testid="hero" {...slider.handlers} />;
}
const { getByTestId } = render(<Probe />);
fireEvent.pointerEnter(getByTestId('hero'), { pointerType: 'mouse' });
expect(slider.paused).toBe(true);
act(() => slider.toggleStopped());
act(() => slider.toggleStopped());
expect(slider.paused).toBe(false);
});
it('afspelen via de knop heft ook de pauze door toetsenbordfocus op', () => {
let slider!: ReturnType<typeof useHeroSlider>;
function Probe() {
slider = useHeroSlider(8);
return (
<section {...slider.handlers}>
<button type="button">knop</button>
</section>
);
}
const { getByRole } = render(<Probe />);
const button = getByRole('button');
// :focus-visible bestaat niet in jsdom; doe alsof het toetsenbordfocus is
vi.spyOn(button, 'matches').mockReturnValue(true);
fireEvent.focus(button);
expect(slider.paused).toBe(true);
act(() => slider.toggleStopped());
expect(slider).toMatchObject({ stopped: true, paused: true });
act(() => slider.toggleStopped());
expect(slider).toMatchObject({ stopped: false, paused: false });
});
});
+26 -3
View File
@@ -7,8 +7,13 @@ const SWIPE_THRESHOLD = 50;
// Houdt de actieve slide bij en of autoplay mag lopen. Het doorschuiven zelf
// gebeurt via de animatie van de voortgangsbalk (zie Hero.tsx), zodat pauzeren
// simpelweg die animatie stilzet.
// Een wissel door de bezoeker (pijl, swipe) wordt gemeld aan schermlezers;
// een automatische wissel niet, anders onderbreekt hij elke paar seconden.
export default function useHeroSlider(count: number) {
const [index, setIndex] = useState(0);
const [byVisitor, setByVisitor] = useState(false);
// Pauzeknop: blijft gelden tot de bezoeker opnieuw klikt (WCAG 2.2.2)
const [stopped, setStopped] = useState(false);
const [hovered, setHovered] = useState(false);
const [focused, setFocused] = useState(false);
const [hidden, setHidden] = useState(() => document.hidden);
@@ -33,16 +38,34 @@ export default function useHeroSlider(count: number) {
// Als de API minder slides teruggeeft dan de huidige index, begin vooraan.
const active = index < count ? index : 0;
const next = () => setIndex((active + 1) % count);
const prev = () => setIndex((active - 1 + count) % count);
const go = (to: number, visitor: boolean) => {
setIndex((to + count) % count);
setByVisitor(visitor);
};
const next = () => go(active + 1, true);
const prev = () => go(active - 1, true);
return {
active,
// Alleen na een wissel door de bezoeker iets te melden
announce: byVisitor,
reducedMotion,
autoplay: count > 1 && !reducedMotion,
paused: hovered || focused || hidden,
paused: stopped || hovered || focused || hidden,
stopped,
// Afspelen via de knop geldt ook terwijl de muis of de
// toetsenbordfocus nog in de hero staat (de klik zelf is een hover en
// vaak een focus); zonder dit gebeurt er na "afspelen" niets zichtbaars.
toggleStopped: () => {
if (stopped) {
setHovered(false);
setFocused(false);
}
setStopped(!stopped);
},
next,
prev,
advance: () => go(active + 1, false),
handlers: {
// Alleen een echte muis pauzeert; een tik op mobiel niet.
onPointerEnter: (event: React.PointerEvent<HTMLElement>) => {