Makes the first render match the prerendered HTML

Search values, the 404 buttons and the footer year now apply after hydration.
The e-mail address stays out of the HTML behind a placeholder, and all review
texts are in the page, so crawlers can read them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-31 18:17:26 +01:00
co-authored by Claude Opus 5.5
parent 1574726c1d
commit 2c2e27e337
32 changed files with 1322 additions and 148 deletions
@@ -1,7 +1,10 @@
import { screen, within } from '@testing-library/react';
import fc from 'fast-check';
import { describe, expect, it } from 'vitest';
import siteContent from '@/content/siteContent';
import { validEmail } from '@/test/arbitraries';
import { axeResults } from '@/test/axe';
import { hydratePage, serverHtml } from '@/test/hydrate';
import { renderWithProviders } from '@/test/renderWithProviders';
import ContactDetails from './ContactDetails';
@@ -104,3 +107,72 @@ describe('ContactDetails', () => {
expect(await axeResults(container)).toHaveNoViolations();
});
});
// The address is only there after hydrating; before, the first item is an
// empty placeholder of the same height (BR-MAIL-04, BR-MAIL-07)
describe('ContactDetails in the prerendered HTML', () => {
it('holds a placeholder first and the socials, but no address', async () => {
const html = await serverHtml(card());
expect(html.toLowerCase()).not.toContain('info@andreaslop.nl');
expect(html).not.toContain('mailto:');
expect(html).toContain('data-testid="contact-details-email-pending"');
expect(html.indexOf('contact-details-email-pending')).toBeLessThan(
html.indexOf('contact-details-instagram'),
);
expect(html).toContain('contact-details-facebook');
});
it('never holds the address, whatever the content (invariant)', async () => {
await fc.assert(
fc.asyncProperty(validEmail, async (email) => {
const html = await serverHtml(card({ email }));
expect(html.toLowerCase()).not.toContain(
`${email.user}@${email.domain}`.toLowerCase(),
);
expect(html).not.toContain('mailto:');
}),
);
});
it('swaps the placeholder for the link after hydrating', async () => {
const { errors } = await hydratePage(card());
const mail = await screen.findByTestId('contact-details-email');
expect(mail).toHaveAttribute(
'href',
'mailto:info@andreaslop.nl?subject=Vraag%20via%20andreaslop.nl',
);
expect(
screen.queryByTestId('contact-details-email-pending'),
).not.toBeInTheDocument();
expect(errors).toEqual([]);
});
it('marks the placeholder hidden, empty and without a link', async () => {
const html = await serverHtml(card());
const doc = new DOMParser().parseFromString(html, 'text/html');
const pending = doc.querySelector('[data-email-pending]')!;
expect(pending.getAttribute('aria-hidden')).toBe('true');
expect(pending.textContent).toBe('');
expect(pending.querySelector('a')).toBeNull();
});
it('has no placeholder on a plain mount', async () => {
const { container } = await renderWithProviders(card());
expect(container.querySelector('[data-email-pending]')).toBeNull();
});
it('has no placeholder without a valid address, only the socials', async () => {
const html = await serverHtml(
card({ email: { user: '', domain: 'andreaslop.nl' } }),
);
expect(html).not.toContain('email-pending');
expect(html).toContain('contact-details-instagram');
});
it('renders nothing without an address and without socials', async () => {
const html = await serverHtml(
card({ email: { user: '', domain: '' }, socials: [] }),
);
expect(html).not.toContain('data-testid="details"');
});
});
@@ -11,6 +11,7 @@ import { Icon } from '@iconify/react/offline';
import Eyebrow from '@/components/Eyebrow/Eyebrow';
import socialPlatforms from '@/content/socialPlatforms';
import type { ContentImage, EmailAddress, SocialLink } from '@/content/types';
import useHydrated from '@/hooks/useHydrated';
import { contactChannels, type ContactChannel } from '@/lib/contactChannels';
type ContactDetailsProps = {
@@ -25,13 +26,18 @@ type ContactDetailsProps = {
'data-testid'?: string;
};
const iconOf = (channel: ContactChannel) =>
// Channels that render as a link; the pending e-mail item is not one
type LinkChannel = Exclude<ContactChannel, { kind: 'email-pending' }>;
const iconOf = (channel: LinkChannel) =>
channel.kind === 'email'
? mailFilled
: socialPlatforms[channel.platform].icon;
// "Direct contact": a card with the ways to reach Andrea, each an icon and a
// link (BR-CD-01..08). Renders nothing when no channel is valid.
// link (BR-CD-01..08). Renders nothing when no channel is valid. Before
// hydration the e-mail item is an empty placeholder of the same height
// (BR-MAIL-04).
export default function ContactDetails({
titleId,
title,
@@ -40,7 +46,8 @@ export default function ContactDetails({
portrait,
'data-testid': testId,
}: ContactDetailsProps) {
const channels = contactChannels(email, socials);
// The address is only assembled after hydration (BR-MAIL-07)
const channels = contactChannels(email, socials, useHydrated());
if (channels.length === 0) return null;
return (
@@ -71,47 +78,57 @@ export default function ContactDetails({
</Eyebrow>
</Flex>
<chakra.ul listStyleType="none" aria-labelledby={titleId}>
{channels.map((channel) => (
<chakra.li key={channel.href}>
<Link
variant="subtle"
href={channel.href}
display="flex"
alignItems="center"
gap={4}
{channels.map((channel) =>
channel.kind === 'email-pending' ? (
<chakra.li
key={channel.kind}
aria-hidden="true"
minH="44px"
{...(channel.external && {
target: '_blank',
rel: 'noopener noreferrer',
})}
data-testid={`contact-details-${
channel.kind === 'email'
? 'email'
: channel.platform
}`}
>
<Box
as="span"
color="accent.deep"
fontSize="1.375rem"
display="inline-flex"
data-email-pending
data-testid="contact-details-email-pending"
/>
) : (
<chakra.li key={channel.href}>
<Link
variant="subtle"
href={channel.href}
display="flex"
alignItems="center"
gap={4}
minH="44px"
{...(channel.external && {
target: '_blank',
rel: 'noopener noreferrer',
})}
data-testid={`contact-details-${
channel.kind === 'email'
? 'email'
: channel.platform
}`}
>
<Icon icon={iconOf(channel)} aria-hidden />
</Box>
{/* Space outside the hidden text, or it drops out
<Box
as="span"
color="accent.deep"
fontSize="1.375rem"
display="inline-flex"
>
<Icon icon={iconOf(channel)} aria-hidden />
</Box>
{/* Space outside the hidden text, or it drops out
of the announced name */}
{channel.label}
{channel.external && (
<>
{' '}
<VisuallyHidden>
(opent in nieuw tabblad)
</VisuallyHidden>
</>
)}
</Link>
</chakra.li>
))}
{channel.label}
{channel.external && (
<>
{' '}
<VisuallyHidden>
(opent in nieuw tabblad)
</VisuallyHidden>
</>
)}
</Link>
</chakra.li>
),
)}
</chakra.ul>
</Box>
);
@@ -5,6 +5,7 @@ import packages from '@/content/packages';
import siteContent from '@/content/siteContent';
import { shootOptions } from '@/lib/shootOptions';
import { axeResults } from '@/test/axe';
import { serverHtml } from '@/test/hydrate';
import { renderWithProviders } from '@/test/renderWithProviders';
import ContactForm from './ContactForm';
@@ -234,3 +235,21 @@ describe('ContactForm', () => {
expect(container.querySelector('[data-robot-check]')).not.toBeNull();
});
});
describe('ContactForm in the prerendered HTML', () => {
it('does not hold the address (BR-MAIL-06)', async () => {
const html = await serverHtml(
<ContactForm
idPrefix="test"
options={options}
mailSubject="Vraag via andreaslop.nl"
email={siteContent.email}
replyTime="1-2 werkdagen"
submit={vi.fn()}
/>,
);
expect(html).toContain('contact-form-submit');
expect(html.toLowerCase()).not.toContain('info@andreaslop.nl');
expect(html).not.toContain('mailto:');
});
});
@@ -26,7 +26,7 @@ import {
INITIAL_CONTACT_STATE,
type ContactFormEvent,
} from '@/lib/contactFormReducer';
import { emailAddress } from '@/lib/emailAddress';
import useEmailAddress from '@/hooks/useEmailAddress';
import { mailtoLink } from '@/lib/mailLink';
import { toContactPayload } from '@/lib/toContactPayload';
import { CONTACT_FIELDS } from '@/lib/validateContact';
@@ -92,7 +92,7 @@ export default function ContactForm({
if (state.status === 'sent') sentMessage.current?.focus();
}, [state.status]);
const address = emailAddress(email);
const { address } = useEmailAddress(email);
const disabled = state.status === 'sending';
if (state.status === 'sent') {
@@ -2,6 +2,8 @@ import { screen } from '@testing-library/react';
import { describe, expect, it } from 'vitest';
import siteContent from '@/content/siteContent';
import { axeResults } from '@/test/axe';
import { cssRulesFor } from '@/test/cssRules';
import { hydratePage, serverHtml } from '@/test/hydrate';
import { renderWithProviders } from '@/test/renderWithProviders';
import ContactFormGate from './ContactFormGate';
@@ -71,3 +73,77 @@ describe('ContactFormGate', () => {
expect(await axeResults(container)).toHaveNoViolations();
});
});
// Before hydrating the notice has the sentence only and reserves the room of
// the address and the button (BR-MAIL-05)
describe('ContactFormGate in the prerendered HTML', () => {
const gate = (email = siteContent.email) => (
<ContactFormGate
enabled={false}
email={email}
subject="Aanvraag fotoshoot: Newborn"
>
<form aria-label="Formulier" />
</ContactFormGate>
);
const prerendered = async (email?: typeof siteContent.email) => {
const html = await serverHtml(gate(email));
const doc = new DOMParser().parseFromString(html, 'text/html');
return { html, doc };
};
it('holds the sentence only, hidden placeholders and no address', async () => {
const { html, doc } = await prerendered();
expect(html.toLowerCase()).not.toContain('info@andreaslop.nl');
expect(html).not.toContain('mailto:');
expect(html).not.toContain('Mail me voor nu op');
expect(html).not.toContain('data-testid="contact-gate-mail"');
expect(
doc.querySelector('[data-testid="contact-gate-notice"]')!
.textContent,
).toContain('Het contactformulier komt binnenkort.');
const pending = doc.querySelector(
'[data-testid="contact-gate-mail-pending"]',
)!;
expect(pending.getAttribute('aria-hidden')).toBe('true');
expect(pending.hasAttribute('data-email-pending')).toBe(true);
expect(pending.getAttribute('href')).toBeNull();
});
it('reserves the width of the lead and the address in characters', async () => {
const { doc } = await prerendered();
const reserved = doc.querySelector('p [data-email-pending]')!;
// Hydrating makes React generate the same classes, which puts their
// rules in the document
await hydratePage(gate());
const probe = document.createElement('span');
probe.className = reserved.className;
// ' Mail me voor nu op ' (20) + 'info@andreaslop.nl' (18)
expect(cssRulesFor(probe).join(' ')).toContain('width: 38ch');
});
it('shows the address, link and button after hydrating', async () => {
const { errors } = await hydratePage(gate());
const mail = await screen.findByTestId('contact-gate-mail');
expect(mail).toHaveAttribute(
'href',
'mailto:info@andreaslop.nl?subject=Aanvraag%20fotoshoot%3A%20Newborn',
);
expect(screen.getByTestId('contact-gate-notice')).toHaveTextContent(
'Het contactformulier komt binnenkort. Mail me voor nu op info@andreaslop.nl',
);
expect(
screen.queryByTestId('contact-gate-mail-pending'),
).not.toBeInTheDocument();
expect(errors).toEqual([]);
});
it('has no placeholders without a valid address', async () => {
const { html } = await prerendered({
user: '',
domain: 'andreaslop.nl',
});
expect(html).not.toContain('email-pending');
expect(html).toContain('Het contactformulier komt binnenkort.');
});
});
@@ -3,7 +3,7 @@ import { Box, chakra, Link, Text, useRecipe } from '@chakra-ui/react';
import Eyebrow from '@/components/Eyebrow/Eyebrow';
import PrivacyNote from '@/components/PrivacyNote/PrivacyNote';
import type { EmailAddress } from '@/content/types';
import { emailAddress } from '@/lib/emailAddress';
import useEmailAddress from '@/hooks/useEmailAddress';
import { mailtoLink } from '@/lib/mailLink';
type ContactFormGateProps = {
@@ -13,6 +13,9 @@ type ContactFormGateProps = {
children: ReactNode;
};
// The text that comes before the address once it is shown
const MAIL_LEAD = ' Mail me voor nu op ';
// Until there is a back-end the form stays visible but dimmed and inert
// under a "coming soon" notice with a mail button (FR-HP-07). inert keeps
// keyboard and screen reader users out of a form that does nothing.
@@ -23,10 +26,11 @@ export default function ContactFormGate({
children,
}: ContactFormGateProps) {
const linkButton = useRecipe({ key: 'linkButton' });
// Assembled after hydration, so the address is nowhere in the HTML or the
// bundle (BR-MAIL-05)
const { available, address } = useEmailAddress(email);
if (enabled) return <>{children}</>;
// Assembled in the browser, so the address is nowhere in the bundle
const address = emailAddress(email);
const href = address ? mailtoLink(address, subject) : undefined;
return (
@@ -49,26 +53,52 @@ export default function ContactFormGate({
data-testid="contact-gate-notice"
>
<Eyebrow>Binnenkort</Eyebrow>
<Text color="ink.soft" mb={address ? 7 : 0}>
<Text color="ink.soft" mb={available ? 7 : 0}>
Het contactformulier komt binnenkort.
{address && (
{address ? (
<>
{' Mail me voor nu op '}
{MAIL_LEAD}
<Link variant="underline" href={href}>
{address}
</Link>
</>
) : (
available && (
// Reserves the width of the lead and the address
// (counted without assembling it), so the line
// breaks where it will after hydration
<chakra.span
display="inline-block"
visibility="hidden"
aria-hidden="true"
w={`${MAIL_LEAD.length + email.user.length + 1 + email.domain.length}ch`}
data-email-pending
/>
)
)}
</Text>
{address && (
<chakra.a
href={href}
css={linkButton({ variant: 'accent' })}
data-testid="contact-gate-mail"
>
Stuur een e-mail
</chakra.a>
)}
{available &&
(address ? (
<chakra.a
href={href}
css={linkButton({ variant: 'accent' })}
data-testid="contact-gate-mail"
>
Stuur een e-mail
</chakra.a>
) : (
// Same recipe and label, so the notice is as high as
// it will be; hidden from sight and from readers
<chakra.span
css={linkButton({ variant: 'accent' })}
visibility="hidden"
aria-hidden="true"
data-email-pending
data-testid="contact-gate-mail-pending"
>
Stuur een e-mail
</chakra.span>
))}
{/* Readable now, while the form's own line is inert (BR-PR-03) */}
<PrivacyNote mt={6} />
</Box>
+96 -1
View File
@@ -1,8 +1,11 @@
import { screen, within } from '@testing-library/react';
import { describe, expect, it } from 'vitest';
import fc from 'fast-check';
import { describe, expect, it, vi } from 'vitest';
import siteContent from '@/content/siteContent';
import type { SiteContent } from '@/content/types';
import { validEmail } from '@/test/arbitraries';
import { axeResults } from '@/test/axe';
import { hydratePage, serverHtml } from '@/test/hydrate';
import { renderWithProviders } from '@/test/renderWithProviders';
import Footer from './Footer';
@@ -126,3 +129,95 @@ describe('Footer', () => {
expect(screen.queryByTestId('footer-email-link')).toBeNull();
});
});
// The page is prerendered and hydrated in the browser: the address and the
// current year only come after hydrating (BR-MAIL-01, BR-HYD-14)
describe('Footer in the prerendered HTML', () => {
const noAddress = (html: string, address: string) => {
expect(html.toLowerCase()).not.toContain(address.toLowerCase());
expect(html).not.toContain('mailto:');
};
it('holds an empty placeholder instead of the address', async () => {
const html = await serverHtml(<Footer content={siteContent} />);
noAddress(html, 'info@andreaslop.nl');
expect(html).not.toContain('footer-email-link');
expect(html).toContain('data-testid="footer-email-pending"');
expect(html).toContain('>Contact</h2>');
});
it('never holds the address, whatever the content (invariant)', async () => {
await fc.assert(
fc.asyncProperty(validEmail, async ({ user, domain }) => {
const html = await serverHtml(
<Footer
content={{ ...siteContent, email: { user, domain } }}
/>,
);
noAddress(html, `${user}@${domain}`);
}),
);
});
it('has no Contact column and no placeholder without a valid address', async () => {
const html = await serverHtml(
<Footer
content={{
...siteContent,
email: { user: '', domain: 'andreaslop.nl' },
}}
/>,
);
expect(html).not.toContain('>Contact</h2>');
expect(html).not.toContain('footer-email-pending');
});
it('shows the placeholder, no link and an empty hidden item while hydrating, then the link', async () => {
const html = await serverHtml(<Footer content={siteContent} />);
const { container, errors } = await hydratePage(
<Footer content={siteContent} />,
);
expect(errors).toEqual([]);
expect(html).toContain('aria-hidden="true"');
await screen.findByTestId('footer-email-link');
expect(screen.getByTestId('footer-email-link')).toHaveAttribute(
'href',
'mailto:info@andreaslop.nl',
);
expect(
container.querySelector('[data-email-pending]'),
).not.toBeInTheDocument();
});
it('uses the build year while hydrating and the current year after', async () => {
vi.stubEnv('VITE_BUILD_YEAR', '2001');
try {
const html = await serverHtml(<Footer content={siteContent} />);
expect(html).toContain('© 2001 Andrea Slop Fotografie');
const { container, errors } = await hydratePage(
<Footer content={siteContent} />,
);
expect(container).toHaveTextContent(
`© ${new Date().getFullYear()} Andrea Slop Fotografie`,
);
expect(errors).toEqual([]);
} finally {
vi.unstubAllEnvs();
}
});
it('shows the current year at once on a plain mount', async () => {
vi.stubEnv('VITE_BUILD_YEAR', '2001');
try {
await renderFooter();
expect(
screen.getByText(
`© ${new Date().getFullYear()} Andrea Slop Fotografie`,
),
).toBeInTheDocument();
} finally {
vi.unstubAllEnvs();
}
});
});
+31 -13
View File
@@ -10,8 +10,9 @@ import {
} from '@chakra-ui/react';
import socialPlatforms from '@/content/socialPlatforms';
import type { SiteContent } from '@/content/types';
import useEmailAddress from '@/hooks/useEmailAddress';
import useHydrated from '@/hooks/useHydrated';
import { copyrightLine } from '@/lib/copyrightLine';
import { emailAddress } from '@/lib/emailAddress';
import { visibleSocials } from '@/lib/visibleSocials';
import { footerNav } from '@/navigation';
import RouterLink from '../RouterLink';
@@ -29,9 +30,15 @@ type FooterProps = {
// copyright en het footermenu. Een lege kolom valt weg (BR-FOOT-01).
export default function Footer({ content }: FooterProps) {
const socials = visibleSocials(content.socials);
// Pas hier samengevoegd, zodat het adres nergens letterlijk staat
const email = emailAddress(content.email);
const year = new Date().getFullYear();
// Het adres wordt pas na de hydratatie samengevoegd, zodat het nergens
// letterlijk in de HTML of de bundel staat (BR-MAIL-01). Ervoor houdt een
// lege plek de ruimte vrij.
const { available, address } = useEmailAddress(content.email);
// Het jaar van de build tot de hydratatie, zodat server en browser
// dezelfde HTML hebben; daarna het huidige jaar (BR-HYD-14)
const year = useHydrated()
? new Date().getFullYear()
: Number(import.meta.env.VITE_BUILD_YEAR);
return (
<Box
@@ -98,16 +105,27 @@ export default function Footer({ content }: FooterProps) {
</FooterColumn>
)}
{email && (
{available && (
<FooterColumn title="Contact">
<chakra.li>
<FooterLink
href={`mailto:${email}`}
data-testid="footer-email-link"
>
{email}
</FooterLink>
</chakra.li>
{address === null ? (
// Even hoog als FooterLink (44px onder lg, daarna
// een tekstregel), zodat de kolom niet verspringt
<chakra.li
aria-hidden="true"
minH={{ base: '44px', lg: '1lh' }}
data-email-pending
data-testid="footer-email-pending"
/>
) : (
<chakra.li>
<FooterLink
href={`mailto:${address}`}
data-testid="footer-email-link"
>
{address}
</FooterLink>
</chakra.li>
)}
</FooterColumn>
)}
</Grid>
@@ -1,5 +1,6 @@
import { act, fireEvent, render, renderHook } from '@testing-library/react';
import { describe, expect, it, vi } from 'vitest';
import { hydrate, renderToString } from '@/test/hydrate';
import useHeroSlider from './useHeroSlider';
// De automatische wissel komt in de browser van animationend op de
@@ -84,3 +85,74 @@ describe('useHeroSlider', () => {
expect(slider).toMatchObject({ stopped: false, paused: false });
});
});
// In de HTML is het tabblad zichtbaar en loopt autoplay; pas na de hydratatie
// telt wat de browser meldt (BR-HYD-09)
describe('useHeroSlider tijdens het hydrateren', () => {
const seen: { paused: boolean; autoplay: boolean }[] = [];
function Probe() {
const { paused, autoplay } = useHeroSlider(3);
seen.push({ paused, autoplay });
return (
<p>
{paused ? 'gepauzeerd' : 'loopt'}
{autoplay ? ' autoplay' : ' stil'}
</p>
);
}
it('geeft in de serverrender een zichtbaar tabblad', () => {
vi.spyOn(document, 'hidden', 'get').mockReturnValue(true);
expect(renderToString(<Probe />)).toContain('loopt');
});
it('leest document.hidden pas na het hydrateren', () => {
vi.spyOn(document, 'hidden', 'get').mockReturnValue(true);
seen.length = 0;
const { container, errors } = hydrate(<Probe />);
expect(seen[0].paused).toBe(false);
expect(container).toHaveTextContent('gepauzeerd');
expect(errors).toEqual([]);
});
it('volgt visibilitychange', () => {
const hidden = vi.spyOn(document, 'hidden', 'get');
hidden.mockReturnValue(false);
const { container } = hydrate(<Probe />);
expect(container).toHaveTextContent('loopt');
act(() => {
hidden.mockReturnValue(true);
document.dispatchEvent(new Event('visibilitychange'));
});
expect(container).toHaveTextContent('gepauzeerd');
});
it('leest document.hidden meteen bij een latere mount', () => {
vi.spyOn(document, 'hidden', 'get').mockReturnValue(true);
seen.length = 0;
render(<Probe />);
expect(seen[0].paused).toBe(true);
});
it('gaat in de eerste render uit van autoplay, ook bij verminderde beweging', () => {
vi.spyOn(window, 'matchMedia').mockImplementation(
(query: string) =>
({
matches: query.includes('reduce'),
media: query,
onchange: null,
addListener: () => {},
removeListener: () => {},
dispatchEvent: () => false,
addEventListener: () => {},
removeEventListener: () => {},
}) as MediaQueryList,
);
seen.length = 0;
const { container } = hydrate(<Probe />);
expect(seen[0].autoplay).toBe(true);
expect(container).toHaveTextContent('stil');
});
});
@@ -5,6 +5,10 @@ import { hasChildren, mainNav } from '@/navigation';
import RouterLink from '../RouterLink';
import MobileNavGroup from './MobileNavGroup';
// Exact, like the submenu: no link counts as current on an unknown URL
// (BR-404-05)
const exactActive = { exact: true, includeSearch: false } as const;
type MobileNavProps = {
id: string;
open: boolean;
@@ -93,6 +97,7 @@ export default function MobileNav({
) : (
<RouterLink
to={item.to}
activeOptions={exactActive}
onClick={() =>
dispatch({ type: 'linkChosen' })
}
@@ -282,3 +282,44 @@ describe('NavigationBar current page', () => {
expect(parent).not.toHaveAttribute('aria-current');
});
});
// The 404 page is prerendered for /404, so on an unknown URL no link may count
// as current in the browser either, also not through the router's fuzzy
// matching of a sub-path (BR-404-05)
describe('NavigationBar and the current page', () => {
const desktopLinks = () =>
[
...screen
.getByRole('navigation', { name: 'Hoofdmenu' })
.querySelectorAll('a'),
].filter((link) => !panel()?.contains(link));
const mobileLinks = () => [
...document.getElementById('mobile-nav')!.querySelectorAll('a'),
];
const currentOf = (links: HTMLElement[]) =>
links
.filter((link) => link.getAttribute('aria-current') === 'page')
.map((link) => link.textContent);
it.each(['/over-mij/x', '/portfolio/x', '/contact/x', '/onbekend'])(
'marks no link as current on the unknown URL %s',
async (path) => {
await renderBar(path);
expect(currentOf(desktopLinks())).toEqual([]);
expect(currentOf(mobileLinks())).toEqual([]);
},
);
it.each([
['/over-mij', 'Over mij'],
['/portfolio?shoot=gezin', 'Portfolio'],
['/contact?pakket=gezin', 'Contact'],
])(
'marks the page itself on %s, also with a search',
async (path, name) => {
await renderBar(path);
expect(currentOf(desktopLinks())).toEqual([name]);
expect(currentOf(mobileLinks())).toEqual([name]);
},
);
});
@@ -24,6 +24,10 @@ import logoDark from '../../assets/logo-dark.png';
// Het item met een submenu: bepaalt of het mobiele menu open start in een sectie
const parentItem = mainNav.find(hasChildren);
// Exact: on an unknown URL (the prerendered 404 page) no link may count as
// current, while the router would match /over-mij/x to Over mij (BR-404-05)
const exactActive = { exact: true, includeSearch: false } as const;
export default function NavigationBar() {
// Eén reducer voor het mobiele menu, de groep en het desktop-submenu, zodat
// ze elkaar niet tegenspreken
@@ -161,7 +165,10 @@ export default function NavigationBar() {
dispatch={dispatch}
/>
) : (
<NavLink to={item.to}>
<NavLink
to={item.to}
activeOptions={exactActive}
>
{item.label}
</NavLink>
)}
@@ -0,0 +1,49 @@
import { screen, waitFor } from '@testing-library/react';
import { describe, expect, it } from 'vitest';
import { hydrateApp } from '@/test/hydrate';
import { renderApp } from '@/test/renderApp';
// The 404 page is prerendered for /404 and served for every unknown URL, so
// the first browser render must not depend on the real path (BR-404-04, 05)
const homeLink = () => screen.queryByTestId('status-page-home-link');
const sectionLink = () => screen.queryByTestId('status-page-section-link');
describe('NotFound while hydrating', () => {
it('shows the section buttons only after hydrating under /soorten-fotoshoots/', async () => {
const { container, errors } = await hydrateApp(
'/404',
'/soorten-fotoshoots/onbekend',
);
await waitFor(() => expect(sectionLink()).toBeInTheDocument());
expect(sectionLink()).toHaveAttribute('href', '/soorten-fotoshoots');
expect(homeLink()).toHaveAttribute('href', '/');
expect(container).toHaveTextContent('Pagina niet gevonden');
expect(errors).toEqual([]);
});
it('keeps one button on an unknown URL outside the section', async () => {
const { container, errors } = await hydrateApp('/404', '/onbekend');
expect(
await screen.findByRole('link', { name: 'Terug naar home' }),
).toBeInTheDocument();
expect(sectionLink()).not.toBeInTheDocument();
expect(container).toHaveTextContent('Pagina niet gevonden');
expect(errors).toEqual([]);
});
});
describe('NotFound on a plain mount', () => {
it('shows the section buttons at once under /soorten-fotoshoots/', async () => {
await renderApp('/soorten-fotoshoots/onbekend');
expect(sectionLink()).toBeInTheDocument();
expect(homeLink()).toBeInTheDocument();
});
it('shows one button at once elsewhere', async () => {
await renderApp('/onbekend');
expect(sectionLink()).not.toBeInTheDocument();
expect(
screen.getByRole('link', { name: 'Terug naar home' }),
).toBeInTheDocument();
});
});
+5 -1
View File
@@ -1,4 +1,5 @@
import { useRouterState } from '@tanstack/react-router';
import useHydrated from '@/hooks/useHydrated';
import { isShootSectionPath } from '@/lib/isShootSectionPath';
import LinkButton from '../LinkButton';
import StatusPage from './StatusPage';
@@ -9,6 +10,9 @@ import StatusPage from './StatusPage';
// Onder /soorten-fotoshoots/ komt er een knop naar het overzicht bij
// (FR-ST-14).
export default function NotFound() {
// De prerender is gemaakt voor /404; het echte pad telt pas na de
// hydratatie, anders verschilt de eerste render van de HTML (BR-404-04)
const hydrated = useHydrated();
const pathname = useRouterState({
select: (routerState) => routerState.location.pathname,
});
@@ -20,7 +24,7 @@ export default function NotFound() {
<StatusPage
title="Pagina niet gevonden"
actions={
isShootSectionPath(pathname) ? (
hydrated && isShootSectionPath(pathname) ? (
<>
<LinkButton
to="/soorten-fotoshoots"
@@ -5,6 +5,7 @@ import homeContent from '@/content/homeContent';
import testimonials from '@/content/testimonials';
import { axeResults } from '@/test/axe';
import { FakeIntersectionObserver } from '@/test/fakeIntersectionObserver';
import { serverHtml } from '@/test/hydrate';
import { renderWithProviders } from '@/test/renderWithProviders';
import { visibleTestimonials } from '@/lib/visibleTestimonials';
import Testimonials from './Testimonials';
@@ -201,3 +202,64 @@ describe('Testimonials', () => {
).toBeNull();
});
});
// Every review is in the prerendered HTML for search engines; the copies
// besides the longest one are hidden and inert (BR-LZY-02)
describe('Testimonials in the prerendered HTML', () => {
const shown = visibleTestimonials(testimonials);
const page = <Testimonials content={content} testimonials={testimonials} />;
it('holds the text of every visible review', async () => {
const doc = new DOMParser().parseFromString(
await serverHtml(page),
'text/html',
);
expect(shown.length).toBeGreaterThan(1);
for (const testimonial of shown) {
expect(
doc.querySelector(
`[data-testid="testimonial-${testimonial.id}"]`,
)?.textContent,
).toContain(testimonial.quote);
}
});
it('puts the longest in the flow and hides the others from readers', async () => {
const doc = new DOMParser().parseFromString(
await serverHtml(page),
'text/html',
);
const longest = shown.reduce((a, b) =>
b.quote.length > a.quote.length ? b : a,
);
for (const testimonial of shown) {
const copy = doc.querySelector(
`[data-testid="testimonial-${testimonial.id}"]`,
)!;
const hidden = copy.closest('[aria-hidden="true"][inert]');
if (testimonial === longest) {
expect(hidden).toBeNull();
} else {
expect(hidden).not.toBeNull();
}
}
});
it('exposes one review to readers while the carousel loads, without axe violations', async () => {
const { container } = await renderWithProviders(page);
const quotes = [...container.querySelectorAll('blockquote')];
expect(quotes).toHaveLength(shown.length);
expect(
quotes.filter((quote) => !quote.closest('[aria-hidden="true"]')),
).toHaveLength(1);
expect(await axeResults(container)).toHaveNoViolations();
});
it('does not add copies for a single review', async () => {
const html = await serverHtml(
<Testimonials content={content} testimonials={[shown[0]]} />,
);
expect(html.match(/data-testid="testimonial-/g)).toHaveLength(1);
expect(html).not.toContain('inert');
});
});
@@ -1,5 +1,5 @@
import { lazy, Suspense } from 'react';
import { Box } from '@chakra-ui/react';
import { Box, VisuallyHidden } from '@chakra-ui/react';
import { DEFERRED_LOAD_MARGIN } from '@/components/DeferredImage/DeferredImage';
import PageSection from '@/components/PageSection/PageSection';
import Reveal from '@/components/Reveal/Reveal';
@@ -71,7 +71,10 @@ export default function Testimonials({
// out exactly like a slide (same padding), plus the controls' height. That
// makes it as tall as the carousel at every screen width, so nothing below
// moves when the carousel takes its place, not even during a scroll to
// #contact that passes this section while it loads.
// #contact that passes this section while it loads. The other reviews are in
// the page too, visually hidden, so the prerendered HTML holds every review
// text for search engines (BR-LZY-02). They are aria-hidden and inert, so
// assistive technology reads each review once, in the carousel.
function CarouselPlaceholder({
testimonials,
}: {
@@ -85,6 +88,15 @@ function CarouselPlaceholder({
<Box ps={{ base: 0, sm: '1.5rem' }} pb={{ base: 0, sm: '1.5rem' }}>
<TestimonialSlide testimonial={longest} />
</Box>
{testimonials
.filter((testimonial) => testimonial !== longest)
.map((testimonial) => (
<VisuallyHidden key={testimonial.id} asChild>
<Box aria-hidden="true" inert>
<TestimonialSlide testimonial={testimonial} />
</Box>
</VisuallyHidden>
))}
{/* The control bar: 48px buttons below the same margin */}
<Box mt="clamp(2.5rem, 5vw, 4rem)" h="48px" />
</Box>