Radio

Description

Radio Buttons are selection controls that enable users to choose a single option from among multiple onscreen options. Selection controls are found where users are asked to make decisions or declare preferences.

See live demos on storybook

Storybook Radio Demos

Install from Artifactory

• Verify that you have access to (https://docs.int.bayer.com/cloud/devops/artifactory/)[Bayer Artifactory]
  • Verify your token is correctly set up in your .npmrc as per the link above
• Verify you have the @element scope configured in your .npmrc
  • @element:registry=https://artifactory.bayer.com/artifactory/api/npm/npm-platforms-engineering/
• Install the component and themes bundles
  • npm i @element/react-components @element/themes
    • alternatively install the component individually along with the themes bundle npm i @element/react-radio @element/themes

Notes

Radios are one of several selection controls. A Radio gives the user two, or usually more, options when taking input. A few notable props for Radio include alignEnd, which changes the alignment of the label and the Radio, checked, which shows the Radio as selected due to either user input or being programmatically set, and hideLabel, which causes the label not be displayed, although it will still be available to screen readers.

Usage

Since many selection inputs exist, Radio is a good choice for scenarios when a few options are presented to a user. When many options exist, Select may be a better option. Checkbox and Switch offer other alternatives for taking user input when only two options are available. Examples and demos of this functionality is included under the corresponding Storybook tabs.

Radio Props

| Name | Type | Default | Required | Description | | ---------- | ----------------------- | --------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | alignEnd | boolean | false | false | Aligns radio to the right of the label. | | checked | string | boolean | null | false | Applies selected state when checked equals value or when checked is set to true. | | className | string | undefined | false | The css class name to be passed through to the component markup. | | disabled | boolean | false | false | Prevents user for interacting with component. | | hideLabel | boolean | false | false | The label not be displayed, but will still be available to screen readers. This should only be used when the context of the radio button is clear and understandable. An example use-case could be as a column in a table where the column header specifies the action. | | id | string | undefined | false | Randomly generated id. May be overwritten. | | label | string|React.ReactNode | null | false | Display label. The label should always be set even when using hideLabel - it will be used by screen readers. | | name | string | null | true | Name of the radio button group. | | themeColor | string | 'primary' | false | Override the default (primary) color with the secondary color. Most commonly used when the control is placed on a darker surface.Accepted Values: primary, secondary, danger, success | | value | string|number | null | false | A custom value will be returned as the second parameter of the change handler. |

Radio Deprecated Render Props

| Name | Type | Default | Required | Deprecated | Description | | -------- | --------------- | --------- | -------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | children | React.ReactNode | undefined | false | Use label instead. | Content to be rendered as the radio label. Can be used instead of label to provide more flexibility. Accepts any valid markup. Warning, if label is set, it will be used instead of child content. |

Radio Events

| Name | Default | Required | Params | Description | | -------- | ------- | -------- | ------ | ------------------------------------------------ | | onChange | null | false | | Fired when value of the radio button is changed. |