FormHelper ARIA integration for validation error states

Answer

Yes. In CakePHP 4.x and 5.x, FormHelper::control() automatically toggles accessibility attributes when a field has a server-side validation error. The input receives aria-invalid="true" and an aria-describedby that points to the automatically generated error message element id. No manual configuration is required for the default templates.

Confirmed facts

• CakePHP 4.x and 5.x FormHelper::control adds aria-invalid="true" to an input when the bound entity reports an error for that field.
• The helper also adds aria-describedby="field-id-error" referencing the error container rendered by the inputContainerError template.
• The wiring is server-side, driven by the entity's error state at render time.

Likely explanation if ARIA is missing

• Custom FormHelper templates that remove the error element id or the aria-describedby link.
• Using low-level helpers like $this->Form->text() instead of control(), which do not add the ARIA wiring automatically.
• Suppressing error rendering with 'error' => false or 'error' => [] on the field.
• CakePHP 3.x or earlier, where this automatic ARIA wiring is not present by default.
• Client-side only validation without populating entity errors before rendering.

Steps needed for this case

1. Ensure the field is rendered with $this->Form->control('field') and the entity has the error via $entity->getErrors() before rendering.
2. Do not disable error output for the field. Keep 'error' => true or omit the option.
3. Keep default templates or verify your inputContainerError template outputs an element with an id that matches the describedby reference, e.g. <div id="{{id}}-error">.
4. Inspect the rendered HTML for an invalid field and confirm aria-invalid="true" and aria-describedby pointing to the error div containing the message.

One diagnostic detail that changes the recommendation: which FormHelper implementation and version you are using. ARIA behavior differs between CakePHP FormHelper 4/5, CakePHP 3.x, and other helpers such as Laravel Collective FormBuilder.