diff --git a/packages/terra-core-docs/CHANGELOG.md b/packages/terra-core-docs/CHANGELOG.md index 7d090124ce8..1a8fd7e252a 100644 --- a/packages/terra-core-docs/CHANGELOG.md +++ b/packages/terra-core-docs/CHANGELOG.md @@ -1,11 +1,13 @@ # Changelog ## Unreleased + * Added * Added drag and drop example for `terra-list`. + * Added instruction note for `terra-form-radio` label hidden example * Updated - * Updated `terra-scroll` to add realistic examples. + * Updated `terra-scroll` to add realistic examples. * Updated all paginator examples to use meaningful titles. * Updated testing recommendations to use `jest.spyOn` instead of `jest.mock`. diff --git a/packages/terra-core-docs/src/terra-dev-site/doc/form-radio/example/radio/HiddenLabelRadioExample.jsx b/packages/terra-core-docs/src/terra-dev-site/doc/form-radio/example/radio/HiddenLabelRadioExample.jsx index 3f59036c479..b70d9336e57 100644 --- a/packages/terra-core-docs/src/terra-dev-site/doc/form-radio/example/radio/HiddenLabelRadioExample.jsx +++ b/packages/terra-core-docs/src/terra-dev-site/doc/form-radio/example/radio/HiddenLabelRadioExample.jsx @@ -1,6 +1,16 @@ import React from 'react'; import Radio from 'terra-form-radio'; -const hiddenLabelRadioExample = () => (); +const hiddenLabelRadioExample = () => ( +
+

+ Note: + Radio button should always have label to ensures that people with visual or cognitive disabilities will recognize radio buttons and understand what information to provide to fill in the fields. +
+ For example: When we have radio fields for selection of account types, authors may feel that just providing programmatically determined names of the fields will be sufficient to identify them. However, even if all the fields have programmatically determined names, a text label must also identify the set of fields as a account type. +

+ +
+); export default hiddenLabelRadioExample; diff --git a/packages/terra-form-radio/CHANGELOG.md b/packages/terra-form-radio/CHANGELOG.md index f8e42f4f936..a94ab5be294 100644 --- a/packages/terra-form-radio/CHANGELOG.md +++ b/packages/terra-form-radio/CHANGELOG.md @@ -2,6 +2,9 @@ ## Unreleased +* Changed + * Updated prop description for `isLabelHidden` prop. + ## 4.41.0 - (August 25, 2023) * Changed diff --git a/packages/terra-form-radio/src/Radio.jsx b/packages/terra-form-radio/src/Radio.jsx index 4fb52777770..1eb5a9a3529 100644 --- a/packages/terra-form-radio/src/Radio.jsx +++ b/packages/terra-form-radio/src/Radio.jsx @@ -35,6 +35,9 @@ const propTypes = { */ isInline: PropTypes.bool, /** + * ![IMPORTANT](https://badgen.net/badge/UX/Accessibility/blue) + * Radio button should always have visible label to meet WCAG 3.3.2 success criterion. + * When set to true, ensure meaningful Text is provided for `labelText` prop. * Whether the label is hidden. */ isLabelHidden: PropTypes.bool,