Accessibility
TheJokeDB should work for everyone who wants a laugh, whatever device or assistive technology they use. This page says what we do about that, where we fall short, and how to tell us.
What we do
Every page is plain HTML that works without JavaScript: voting, searching, browsing and submitting a joke are ordinary forms. Scripts only add conveniences on top, such as fetching the next joke without a page load.
Pages carry one heading structure, landmarks for the header, navigation, main content and footer, and labels on every form control. Links say where they go; icons have text alternatives; the colour scheme follows your system setting, and light and dark both keep text contrast at or above the WCAG AA level. Nothing flashes, autoplays or moves on its own apart from a short laugh animation that respects the reduced-motion setting.
The site is usable from the keyboard alone: menus are native disclosure elements, focus is visible, and the order of controls follows the page. Text scales with your browser’s zoom and text-size settings.
Where we fall short
Jokes are user-submitted text and are not written for simplicity; some rely on wordplay that does not survive a screen reader’s pronunciation. The share image for each joke carries the joke as text in its alternative attribute, but a visual joke (a list, a formatted exchange) can lose its shape in speech. Advertising, where present, comes from third parties and is outside our control.
We aim to meet WCAG 2.2 at level AA and test with VoiceOver, keyboard-only use and the browser’s zoom. We have not yet had an external audit.
Tell us
If something on the site is hard or impossible for you to use, write to [email protected] and say which page and what happened. We treat accessibility reports as bugs and fix them in the order they come in.