Announces manual hero slide changes and adds a pause button
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:
@@ -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} />,
|
||||
|
||||
@@ -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 });
|
||||
});
|
||||
});
|
||||
@@ -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>) => {
|
||||
|
||||
Reference in New Issue
Block a user