1.1.2 • Published 1 year ago

chakra-radio-group v1.1.2

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

Chakra Radio Group

This component is a custom solution for Radio Group Select, built with @chakra-ui/react and react-render-prop-type.

Usage

To use this package install it with one of these commands:

npm install chakra-radio-group

or

yarn add chakra-radio-group

Example

<RadioGroup
  options={[{ title: 'Test Title' }]}
  getOptionValue={({ title }) => title}
  hoverStyles={{
    outlineWidth: '1px',
    outlineColor: 'blue.300',
    outlineStyle: 'solid',
  }}
  focusStyles={{
    outlineWidth: '1px',
    outlineColor: 'blue.500',
    outlineStyle: 'solid',
  }}
>
  {({ option, radioProps }) => (
    <Flex
      bgColor={radioProps.isChecked ? 'blue.200' : 'blue.50'}
      p="5"
      minW="48"
      align="center"
    >
      <Text>{option.title}</Text>
    </Flex>
  )}
</RadioGroup>

Props

Radio Group

  • options - ❗️ - Array of objects
  • getOptionValue - ❗️ - A function that chooses which property from the object from options will be chosen as the value for Radio Group Item component
  • value - - String value from options which matches the key from getOptionValue function
  • defaultValue - - String value from options which matches the key from getOptionValue function
  • name - - String value which sets the input name attribute
  • onChange - - Custom function to handle the onChange event
  • generalStyles - - Object of multiple CSS properties to style Radio Group Item component
  • hoverStyles - - Object of multiple CSS properties which are set on hover state
  • focusStyles - - Object of multiple CSS properties which are set on focus state

Radio Group - Render Props

  • option - Object from options
  • radioProps - Object which contains Radio Group id, name, value, state, etc.

❗️ = Required property

❓ = Optional property

Storybook

To test out the package, clone the repository to your local machine and use one of following commads:

npm run storybook

or

yarn storybook

This loads the stories from ./stories.