Issue Bug Resolved

#110437EXT:form: MultiCheckbox group is exposed as role="radiogroup", announcing single selection

Sebastian Mendel 08/11/26, 12:07 updated 08/14/26, 13:45

Description

Problem

MultiCheckbox.fluid.html wraps its checkboxes in a container carrying role="radiogroup":

typo3/sysext/form/Resources/Private/Frontend/Partials/MultiCheckbox.fluid.html:7

<div id="{element.uniqueIdentifier}" class="{errorClass}" role="radiogroup" aria-label="{element.label}">

That is the same line as in RadioButton.fluid.html:7, where it is correct.

radiogroup states that the group’s owned elements are radios and that exactly one of them may be selected. The children here are <input type="checkbox">, so the role contradicts both the markup and the purpose of the element. A screen reader announces the group as a radio group and reports each option in a single-selection context, telling the user they must pick one option where they may pick any number.

WAI-ARIA requires the owned elements of radiogroup to have role="radio"; axe-core reports this as aria-required-children. The correct role for a set of related checkboxes is group — which <fieldset> already conveys natively, so removing the attribute is equally valid where the partial renders inside a fieldset with a legend.

Steps to reproduce

  1. Create a form with a Multi checkbox element carrying two or more options.
  2. Render it in the frontend.
  3. Inspect the container: <div id="…" role="radiogroup" aria-label="…"> containing input[type=checkbox].
  4. Run axe-core against the page, or read the group with a screen reader.

Expected

The group is exposed as a group of checkboxes: role="group", or no role at all where the surrounding <fieldset> already provides it.

Actual

The group is exposed as role="radiogroup".

Suggested patch

--- a/typo3/sysext/form/Resources/Private/Frontend/Partials/MultiCheckbox.fluid.html
+++ b/typo3/sysext/form/Resources/Private/Frontend/Partials/MultiCheckbox.fluid.html
@@
-            <div id="{element.uniqueIdentifier}" class="{errorClass}" role="radiogroup" aria-label="{element.label}">
+            <div id="{element.uniqueIdentifier}" class="{errorClass}" role="group" aria-label="{element.label}">

Affected versions

Verified by reading the partial:

  • main — affected
  • v14.3.5 (composer install) — affected
  • 13.4 and 12.4 — not affected: the container there is <div class="inputs-list"> with no role, so this arrived with v14.

RadioButton.fluid.html carries the same attribute correctly and must not be changed. MultiSelect.fluid.html sets no role and is unaffected.

Not a duplicate of

  • #105459 and #104682 — both concern the label/input nesting in the checkbox and radio partials, not the role on the group container.

Notes

Found while building a TYPO3 extension whose demonstration form leans on this element: two of its groups carry more than twenty options each, so the single-selection announcement is not a cosmetic detail there. That extension corrects the role from JavaScript on its own form as a stopgap; the fix belongs here.

Reviews 2

History 15

  1. Sebastian Mendel commented and changed status Under Review Resolved done 0 % 100 % <span data-processor="relativetime" data-value="2026-08-14T13:45:11+00:00" > 08/14/26, 13:45 </span>

    Applied in changeset commit:e35a1105eab9e58aeaed97727d2310ced89e4472.