Radio Button
Radio buttons allow users to select a single option from a list options. All possible options are exposed up front for users to compare.
Usage
import { RadioButton } from '@elegantui/forms';
Basic Example
import { RadioButton } from '@elegantui/forms';
export default function App() {
return (
<RadioButton name='default' radioButtonText='RadioButton' value='radio' />
);
}
Variants
RadioButton component is available in six variants.
import { RadioButton } from '@elegantui/forms';
export default function App() {
return (
<RadioButton
name='primary'
value='primary'
radioButtonText='Primary'
variant='primary' // 'default' | 'secondary' | 'success' | 'warning' | 'error'
/>
);
}
RadioButton Text
RadioButton component allows adding text next to the radio button using the radioButtonText prop.
import { RadioButton } from '@elegantui/forms';
export default function App() {
return (
<RadioButton
name='primary'
value='primary'
radioButtonText='Primary'
variant='primary'
/>
);
}
Selected state
RadioButton component can be configured to have a default selected state by using the checked prop.
import { RadioButton } from '@elegantui/forms';
export default function App() {
return (
<RadioButton
name='primary'
value='primary'
radioButtonText='Primary'
variant='primary'
checked
/>
);
}
Disabled state
RadioButton component can be configured to have a disabled state by using the disabled prop.
import { RadioButton } from '@elegantui/forms';
export default function App() {
return (
<RadioButton
name='primary'
value='primary'
radioButtonText='Primary'
variant='primary'
disabled
/>
);
}
Custom styles
RadioButton component allows you to configure your own styles. Styles can be provided either through the React style prop or CSS classes using className prop.
Available Props
| Prop | Values | Default |
|---|---|---|
| name | string | -- |
| radioButtonText | string | -- |
| value | string | -- |
| onChange | () => void | -- |
| checked | true | false | false |
| variant | default | primary | secondary | error | success | warning | primary |
| disabled | true | false | false |
| className | string | -- |
| ...rest | React.InputHTMLAttributes<HTMLInputElement> | -- |