This package adds functionality to Symfony Form to help improve form accessibility. It can also be used for forms within Laravel.
The web was designed to work for everyone. Accessibility is an important part of this, ensuring your website is available to everyone, regardless of disability or access needs.
Technically, accessibility is a set of guidelines to ensure websites and digital tools (for example, an application form or content management system) are developed to remove barriers which make them difficult or impossible to use.
Access needs can be varied: a person may be visually impaired; they may be a keyboard-only user and not be able to use a mouse; they may have a temporary health condition that changes how they use the web; they may be in a noisy environment and unable to hear audio. All of us have different access needs as we get older. Accessibility is also about making your website work for the future you.
Most people would agree they want to build websites that are easy to use, robust and don't exclude people. Accessibility is an important factor in achieving this on the web.
You can read and watch many great accessibility resources on the WAI website.
The best practice is to validate a form on submission. It is recommended to avoid default HTML5 form validation.
The Form class defaults to add the novalidate attribute to your form.
To notify a user of an error with their form submission:
- Indicate an error by prefixing the document’s
title. See Indicate form errors in the page title. - Place an error summary at the top of the page. See Error summary.
- Add an error message to each problematic input.
Symfony Form will automatically display an error message next to the input field. Error messages should have a unique ID and be associated with the form input via the aria-describedby attribute.
This is provided in the accessible form theme.
- Using accessible forms with Laravel
- Using accessible forms with Symfony
- Form helpers to create a form
- Accessible form theme
- GOV.UK Design System form theme
- Indicate form errors in the page title
- Error summary
- Every input field needs a label
- Indicate required fields
- Use field hints instead of placeholders
- Using autocomplete to hint input fields
- Twig helpers reference
- [] Make error summary HTML work
- [] Update HTML form theme
- [] Add Laravel service provider, add accessible-forms-laravel to create Laravel package loader, see https://laravel.com/docs/12.x/packages#package-discovery
- [] Add Symfony service provider
- [] Add tests