Accessibility and responsive behavior¶

NewAdmin keeps Django controls and forms, and adds visible focus, mobile navigation, contrasting surfaces, and horizontally scrollable tables. The goal is WCAG 2.2 AA for its components; this alpha is not a conformance certification.

Navigation and keyboard¶

The first link skips to the main content.
On desktop, the sidebar button keeps Django’s native collapse and filter.
At widths up to 767 px, the navigation button reveals the menu in the page flow without covering content. It starts closed on every page and does not change the desktop collapse preference.
Enter or Space activates the button. Escape closes the mobile menu and returns focus. If the filter contains text, the first Escape clears it and the next closes the menu.
Hidden links are removed from the tab order. Table regions can receive focus and scroll horizontally when their columns require it.

The design uses logical properties for RTL. Reflow regression checks cover 320, 768, 1024, and 1440 CSS pixels. A 320 px viewport checks reflow equivalent to a 1280 px window at 400% zoom; it does not replace testing real zoom in the consumer project’s browsers and assistive technologies.

Appearance¶

Light, dark, and automatic modes share design tokens. Reduced-motion preferences are respected. The glass finish has an opaque fallback, is reduced for reduced transparency preferences, and is disabled in forced-colors mode. Chart data is also available in HTML tables.

The theme labels native autocomplete and file controls that need accessible names, including new inlines. It keeps explicit labels and names supplied by consumers. Menu icons are decorative.

Verification scope¶

Browser tests run axe-core on login, generic dashboard, changelist, article form, and password change in light and dark modes. Other tests cover ECharts dashboards, form errors, widgets, popups, and inlines. Keyboard use, focus, RTL, reflow, and motion/transparency preferences are checked.

Automated checks do not guarantee correct output with every screen reader. Review content, reading order, real zoom, and screen readers in your own project. Customizations, charts, and third-party widgets need their own audit.

Desktop collapse and filtering use Django’s native storage; a browser that fully blocks localStorage/sessionStorage can limit those native controls. The theme’s appearance has a fallback without storage.