<Checkbox />

Inputs of type checkbox. Checkboxes should be wrapped in a CheckboxGroup.

Example

import React from 'react';
import { Form, Checkbox, CheckboxGroup } from '@availity/form';
import { Button } from 'reactstrap';
import * as yup from 'yup';

const Example = () => (
  <Form
    initialValues={{
      hello: [],
    }}
    onSubmit={() => {}}
    validationSchema={yup.object().shape({
      hello: yup.array().required('At least one checkbox is required'),
    })}
  >
    <CheckboxGroup name="hello" label="Checkbox Group">
      <Checkbox groupName="hello" label="Check One" value="uno" />
      <Checkbox groupName="hello" label="Check Two" value="dos" />
      <Checkbox groupName="hello" label="Check Three" value="tres" />
      <Checkbox
        groupName="checkboxGroup"
        label={<>Check Four</>}
        value="cuatro"
      />
    </CheckboxGroup>
    <Button type="submit" color="primary">
      Submit
    </Button>
  </Form>
);

Live example: Storybook

Props

id?: string

Id and name for the checkbox.

groupName?: string

Should match <CheckboxGroup /> name to accessibly link input to form feedback.

label?: ReactNode

Label for the checkbox.

helpId?: string

Help topic id, adds <FieldHelpIcon/> next to the label (should not be within label for accessibility).

value?: string

Value of the checkbox.

disabled?: boolean

Disables the checkbox.

inline?: boolean

Will render the checkbox inline with other checkboxes. Default: true.