# CheckboxGroup
Die CheckboxGroup fasst mehrere Checkboxen oder CheckboxButtons logisch in einer Gruppierung zusammen.
## Overview
# Playground
Verwende `` zusammen mit mehreren `` oder
``, um eine CheckboxGroup darzustellen. Über der
CheckboxGroup kann ein beschreibendes
[Label](/04-components/content/label/overview) verwendet werden.
```tsx
import {
Checkbox,
CheckboxGroup,
Label,
} from "@mittwald/flow-react-components";
LesenSchreiben
```
---
# CheckboxButtons
Eine CheckboxGroup kann entweder mit
[CheckboxButtons](/04-components/form-controls/checkbox-button/overview) oder
[Checkboxen](/04-components/form-controls/checkbox/overview) gefüllt werden.
```tsx
import {
CheckboxButton,
CheckboxGroup,
Label,
} from "@mittwald/flow-react-components";
LesenSchreiben
```
---
# Spalten
Die CheckboxGroup verwendet das
[ColumnLayout](/04-components/structure/column-layout/overview), um eine
Anpassung der Spalten zu ermöglichen. Bei der Verwendung von CheckboxButtons
entspricht der Default dem des ColumnLayouts, während Checkboxen im Default
untereinander angezeigt werden.
```tsx
import {
CheckboxButton,
CheckboxGroup,
Label,
} from "@mittwald/flow-react-components";
LesenSchreiben
```
---
# Kombiniere mit ...
## FieldDescription
Um wichtige Hinweise zu den Auswahloptionen der CheckboxGroup bereitzustellen,
kann unterhalb der Gruppe eine `` eingebaut werden.
```tsx
import {
Checkbox,
CheckboxGroup,
FieldDescription,
Label,
} from "@mittwald/flow-react-components";
LesenSchreibenWeitere Informationen
```
## ContextualHelp
Benutze das [ContextualHelp](/04-components/overlays/contextual-help/overview),
um weitere Informationen bereitstellen zu können.
```tsx
import {
Button,
Checkbox,
CheckboxGroup,
ContextualHelp,
ContextualHelpTrigger,
Heading,
Label,
Text,
} from "@mittwald/flow-react-components";
LesenSchreiben
```
## React Hook Form
```tsx
import {
Checkbox,
CheckboxGroup,
Label,
Section,
} from "@mittwald/flow-react-components";
import { useForm } from "react-hook-form";
import {
Form,
SubmitButton,
typedField,
} from "@mittwald/flow-react-components/react-hook-form";
import { sleep } from "@/content/04-components/actions/action/examples/lib";
export default () => {
const form = useForm<{ permissions: string[] }>();
const Field = typedField(form);
return (
);
}
```
## Develop
# Properties
| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `id` | `string` | - | The element's unique identifier. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id). |
| `translate` | `"yes" \| "no"` | - | - |
| `className` | `ClassNameOrFunction` | `'react-aria-CheckboxGroup'` | The CSS [className](https://developer.mozilla.org/en-US/docs/Web/API/Element/className) for the element. A function may be provided to compute the class based on component state. |
| `style` | `StyleOrFunction` | - | The inline [style](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/style) for the element. A function may be provided to compute the style based on component state. |
| `render` | `DOMRenderFunction<"div", TooltipRenderProps>` | - | Overrides the default DOM element with a custom render function. This allows rendering existing components with built-in styles and behaviors such as router links, animation libraries, and pre-styled components. Requirements: - You must render the expected element type (e.g. if `