a11y-forms

Ensure HTML forms implement accessible names, grouping, and validation feedback.

9|Updated Jan 18, 2025
One-click install
npx skills add https://github.com/TheNordicOne/ngx-formbar --skill a11y-forms
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: a11y-forms
Source: https://github.com/TheNordicOne/ngx-formbar/tree/main/.claude/skills/a11y-forms
Command: npx skills add https://github.com/TheNordicOne/ngx-formbar --skill a11y-forms

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Accessible forms often fail when controls lack proper names, grouping, input semantics, or error announcements, creating barriers for screen reader and assistive technology users.

Core Features & Use Cases

  • Labelling that actually exposes an accessible name: Use explicit label associations and avoid placeholder-only labeling, including icon-only control labeling.
  • Correct structure and semantics: Group related controls with fieldset and legend, and use appropriate input types to improve autofill and validation behavior.
  • Reliable validation feedback: Mark invalid fields, connect errors via aria-describedby, and announce form-level issues with alert roles or aria-live.

Quick Start

Activate this skill while writing or editing HTML forms to ensure every input, group, and error message is implemented with accessible names, correct semantics, and screen reader-friendly validation announcements.

Frequently Asked Questions about a11y-forms

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make HTML forms accessible to screen readers?

To make HTML forms accessible to screen readers, you must use explicit label associations, group related controls with fieldset and legend, and use appropriate input types to ensure correct semantics and autofill behavior.

How do I announce validation errors with aria live regions?

To announce validation errors with aria live regions, mark invalid fields, connect error messages via aria-describedby, and use alert roles or aria-live attributes to announce form-level issues to screen reader users.

Why do screen readers not announce my form input names correctly?

Screen readers fail to announce form input names correctly when using placeholder-only labeling or missing explicit label associations; you must bind labels to inputs to expose a proper accessible name.

Do I need autocomplete attributes for accessible form inputs?

Yes, adding autocomplete attributes to appropriate input types improves autofill behavior and is required for accessible forms, ensuring credential and personal fields are properly identified by assistive technologies.

What is the best way to group related form fields for accessibility?

The best way to group related form fields for accessibility is using the fieldset and legend elements, which provide semantic grouping and descriptive context that screen readers use to navigate controls.

How do I label icon-only form controls for screen readers?

To label icon-only form controls for screen readers, provide an explicit accessible name instead of relying on visual icons alone, ensuring the control's purpose is announced correctly to assistive technology users.