🐛 [BUG - React] - FormControl.Required not indicated with Checkbox about brand

[mperrotti]

@philernst - I'm not sure we even need a required indicator on that one. I think it would be ok to just return a validation error if it isn't checked.

[mperrotti]

@philernst @rezrah - this is intentional. A single checkbox cannot be required because both checked (true) and unchecked (false) are valid values.

We should update the docs with this information.

[mperrotti]

If you want indicate that a selection must be made in a group of checkboxes, it should be indicated for that whole group of checkboxes. Here's an example from @primer/react: https://primer.style/react/storybook/?path=/story/components-checkboxgroup--playground&args=required:!true

[philernst]

@mperrotti Got it. The use case I was thinking about is where the submitter is required to check the checkbox to submit the form. For example:

I suppose in that situation a CheckboxGroup would need to be added to indicate that the field is required to be true to submit the form.

[rezrah]

A single checkbox cannot be required because both checked (true) and unchecked (false) are valid values.

We should update the docs with this information.

cc. @jesskuo4 - could we add this guidance into your upcoming checkbox interface guidelines please?

[philernst]

That sounds good to me. The browser validation error does indeed work.

Thank you all!