grommet
components

RadioButton

a radio button control

Storybook
CodeSandbox

Props

checked

Same as React <input checked={} />
truefalse

children

Function that will be called to render the visual representation. It will be passed an object indicating whether the button is checked. It should return a react element. For example: children={({ checked }) =&gt; &lt;Box ...>{...}</Box>}

({ checked }) => {...}

disabled

Same as React <input disabled={} />. Also adds a hidden input element with the same name so form submissions work.

truefalse

id

The DOM id attribute value to use for the underlying <input/> element.
"string"

label

Label text to place next to the control.
"node"

name

The DOM name attribute value to use for the underlying <input/> element.

"string"

onChange

Function that will be called when the user clicks the radio button. It will be passed a React event object. The current state can be accessed via event.target.checked. Same as React <input onChange={} />.

({ target: { checked } }) => {...}

Theme

radioButton.border.color

The color of the border of the Radio Button.
{
  "dark": "rgba(255, 255, 255, 0.5)",
  "light": "rgba(0, 0, 0, 0.15)"
}

radioButton.border.width

The width size of the border of the RadioButton.
"2px"

radioButton.check.color

The color of the checked icon in the RadioButton.
string | { dark: string, light: string }

radioButton.check.extend

Any additional style for the checked RadioButton.
"any CSS"
(props) => {}

radioButton.check.radius

The border-radius of the RadioButton.
"100%"

radioButton.color

The color of the border surrounding the checked icon in RadioButton checked state.

string | { dark: string, light: string }

radioButton.extend

Any additional style for the RadioButton.
"any CSS"
(props) => {}

radioButton.gap

The gap between the label and the RadioButton itself.
"small"

radioButton.size

The size of the RadioButton.
"24px"

radioButton.hover.border.color

The color of the RadioButton border when hovered over.
{"dark": "white", "light": "black"}

radioButton.icon.extend

Any additional style for the RadioButton icon.
"any CSS"
(props) => {}

radioButton.icon.size

The size of the icon in the RadioButton.
string