# Section

Eine Section erhöht die Übersichtlichkeit, indem sie den Content in vertikale Teilbereiche mit festen Abständen gliedert. Zwischen mehreren Sections wird automatisch ein Separator eingefügt, um die Bereiche optisch zu trennen.

## Overview

# Playground

Verwende `<Section />`, um eine Section darzustellen. Sie sorgt automatisch für
feste Abstände zwischen den darin platzierten Elementen.

```tsx
import {
  Heading,
  Section,
  Text,
} from "@mittwald/flow-react-components";

<Section>
  <Heading>Newsletter</Heading>
  <Text>
    Kommende Releases, neue Features und Tipps rund um dein
    Hosting – wir bringen dir das Wichtigste in dein
    Postfach. Abonniere unseren Newsletter und bleib auf dem
    Laufenden.
  </Text>
</Section>
```

---

# Mehrere Sections

Wenn mehrere Sections untereinander platziert werden, werden sie automatisch
durch einen [Separator](/04-components/structure/separator/overview) getrennt.

```tsx
import {
  Button,
  Header,
  Heading,
  Section,
  Text,
} from "@mittwald/flow-react-components";

<>
  <Section>
    <Header>
      <Heading>Datenbanken</Heading>
      <Button>Datenbank verknüpfen</Button>
    </Header>
    <Text>
      Eine Datenbank, die mit einer App verknüpft ist, kann
      nicht gelöscht werden. Die App nutzt immer die
      verknüpfte Datenbank.
    </Text>
  </Section>
  <Section>
    <Heading>Cronjobs</Heading>
    <Text>
      Ein Cronjob ist immer fest einer App zugeordnet, du
      kannst ihn unter dem Menüpunkt Cronjobs bearbeiten und
      löschen.
    </Text>
  </Section>
</>
```

## Sub-Headings

Sections beginnen in der Regel mit einer
H2-[Heading](/04-components/content/heading/overview). Wenn eine feinere
Unterteilung nötig ist, können Headings auf niedrigerem Level direkt in der
Section platziert werden. Zur optischen Verdeutlichung erhalten Sub-Headings in
der Größe H3 automatisch einen größeren Abstand zum darüberliegenden Content.

```tsx
import {
  Heading,
  InlineCode,
  Label,
  LabeledValue,
  Section,
  Text,
} from "@mittwald/flow-react-components";

<Section>
  <Heading>DNS Verwaltung</Heading>
  <Text>
    Da du externe Nameserver nutzt, empfehlen wir dir
    folgende Records bei deinem Provider einzutragen.
  </Text>
  <Heading level={3}>A-Record</Heading>
  <LabeledValue>
    <Label>IPv4-Adresse</Label>
    <InlineCode>12.123.123.12</InlineCode>
  </LabeledValue>
</Section>
```

---

# SectionAction

Die Section verfügt in der rechten oberen Ecke über einen Bereich für Actions –
die sogenannte SectionAction. Dort können ein
[Link](/04-components/navigation/link/overview), ein
[Switch](/04-components/form-controls/switch/overview), ein oder zwei
[Buttons](/04-components/actions/button/overview) oder eine Kombination dieser
Components verwendet werden.

```tsx
import {
  Header,
  Heading,
  Link,
  Section,
  Text,
} from "@mittwald/flow-react-components";

<Section>
  <Header>
    <Heading>Newsletter</Heading>
    <Link href="#">Zur Anmeldung</Link>
  </Header>
  <Text>
    Kommende Releases, neue Features und Tipps rund um dein
    Hosting – wir bringen dir das Wichtigste in dein
    Postfach. Abonniere unseren Newsletter und bleib auf dem
    Laufenden.
  </Text>
</Section>
```

```tsx
import {
  Header,
  Heading,
  Section,
  Switch,
  Text,
} from "@mittwald/flow-react-components";

<Section>
  <Header>
    <Heading>Autoresponder</Heading>
    <Switch>Aktivieren</Switch>
  </Header>
  <Text>
    Lasse den Autoresponder für dich arbeiten. Er kann
    automatisch auf eingehende E-Mails antworten.
  </Text>
</Section>
```

Es können maximal zwei [Buttons](/04-components/actions/button/overview)
nebeneinander angezeigt werden. Werden mehr als zwei Aktionen benötigt, erhält
die Hauptaktion einen eigenen Button, während alle weiteren in ein
[ContextMenu](/04-components/actions/context-menu/overview) verschoben werden.

```tsx
import {
  Button,
  ColumnLayout,
  Content,
  ContextMenu,
  ContextMenuTrigger,
  CopyButton,
  Header,
  Heading,
  IconContextMenu,
  IconExternalLink,
  Label,
  LabeledValue,
  Link,
  MenuItem,
  Section,
  Text,
} from "@mittwald/flow-react-components";

<Section>
  <Header>
    <Heading>Mein Projekt</Heading>

    <ContextMenuTrigger>
      <Button
        variant="soft"
        color="secondary"
        aria-label="Weitere Aktionen anzeigen"
      >
        <IconContextMenu />
      </Button>
      <ContextMenu aria-label="Weitere Aktionen">
        <MenuItem>Datenbank migrieren</MenuItem>
        <MenuItem>Volume migrieren</MenuItem>
      </ContextMenu>
    </ContextMenuTrigger>

    <Button color="danger">Deaktivieren</Button>
  </Header>

  <ColumnLayout>
    <LabeledValue>
      <Label>Projektname</Label>
      <Content>Dolce Vita</Content>
    </LabeledValue>
    <LabeledValue>
      <Label>Short-ID</Label>
      <Content>p-lol3qe</Content>
      <CopyButton text="p-lol3qe" />
    </LabeledValue>
    <LabeledValue>
      <Label>Projektdomain</Label>
      <Link>
        <Text>p-lol3qe.project.space</Text>
        <IconExternalLink />
      </Link>
      <CopyButton text="p-lol3qe.project.space" />
    </LabeledValue>
  </ColumnLayout>
</Section>
```

---

# Kombiniere mit ...

## AlertBadge und Badge

Die [Heading](/04-components/content/heading/overview) kann mit einem
[AlertBadge](/04-components/status/alert-badge/overview) oder einem
[Badge](/04-components/status/badge/overview) ergänzt werden. Dadurch wird der
User schnell über den Status oder über Metadaten des Inhalts einer Section
informiert.

```tsx
import {
  AlertBadge,
  Button,
  ColumnLayout,
  Content,
  CopyButton,
  Header,
  Heading,
  IconExternalLink,
  Label,
  LabeledValue,
  Link,
  Section,
  Text,
} from "@mittwald/flow-react-components";

<Section>
  <Header>
    <Heading>
      Mein Projekt
      <AlertBadge status="danger">Deaktiviert</AlertBadge>
    </Heading>

    <Button variant="soft" color="secondary">
      Datenbank migrieren
    </Button>
    <Button color="accent">Aktivieren</Button>
  </Header>

  <ColumnLayout>
    <LabeledValue>
      <Label>Projektname</Label>
      <Content>Dolce Vita</Content>
    </LabeledValue>
    <LabeledValue>
      <Label>Short-ID</Label>
      <Content>p-lol3qe</Content>
      <CopyButton text="p-lol3qe" />
    </LabeledValue>
    <LabeledValue>
      <Label>Projektdomain</Label>
      <Link>
        <Text>p-lol3qe.project.space</Text>
        <IconExternalLink />
      </Link>
      <CopyButton text="p-lol3qe.project.space" />
    </LabeledValue>
  </ColumnLayout>
</Section>
```


## Develop

# Properties

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `ref` | `Ref<HTMLSpanElement>` | - | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). @see [React Docs](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) |
| `key` | `Key` | - | - |
| `defaultChecked` | `boolean` | - | - |
| `defaultValue` | `string \| number \| readonly string[]` | - | - |
| `suppressContentEditableWarning` | `boolean` | - | - |
| `suppressHydrationWarning` | `boolean` | - | - |
| `accessKey` | `string` | - | - |
| `autoCapitalize` | `"none" \| (string & {}) \| "off" \| "on" \| "sentences" \| "words" \| "characters"` | - | - |
| `autoFocus` | `boolean` | - | - |
| `className` | `string` | - | - |
| `contentEditable` | `Booleanish \| "inherit" \| "plaintext-only"` | - | - |
| `contextMenu` | `string` | - | - |
| `dir` | `string` | - | - |
| `draggable` | `Booleanish` | - | - |
| `enterKeyHint` | `"enter" \| "done" \| "go" \| "next" \| "previous" \| "search" \| "send"` | - | - |
| `hidden` | `boolean` | - | - |
| `id` | `string` | - | - |
| `lang` | `string` | - | - |
| `nonce` | `string` | - | - |
| `slot` | `string` | - | - |
| `spellCheck` | `Booleanish` | - | - |
| `style` | `CSSProperties` | - | - |
| `tabIndex` | `number` | - | - |
| `title` | `string` | - | - |
| `translate` | `"yes" \| "no"` | - | - |
| `radioGroup` | `string` | - | - |
| `role` | `AriaRole` | - | - |
| `about` | `string` | - | - |
| `content` | `string` | - | - |
| `datatype` | `string` | - | - |
| `inlist` | `any` | - | - |
| `prefix` | `string` | - | - |
| `property` | `string` | - | - |
| `rel` | `string` | - | - |
| `resource` | `string` | - | - |
| `rev` | `string` | - | - |
| `typeof` | `string` | - | - |
| `vocab` | `string` | - | - |
| `autoCorrect` | `string` | - | - |
| `autoSave` | `string` | - | - |
| `color` | `string` | - | - |
| `itemProp` | `string` | - | - |
| `itemScope` | `boolean` | - | - |
| `itemType` | `string` | - | - |
| `itemID` | `string` | - | - |
| `itemRef` | `string` | - | - |
| `results` | `number` | - | - |
| `security` | `string` | - | - |
| `unselectable` | `"off" \| "on"` | - | - |
| `popover` | `"" \| "auto" \| "manual" \| "hint"` | - | - |
| `popoverTargetAction` | `"toggle" \| "show" \| "hide"` | - | - |
| `popoverTarget` | `string` | - | - |
| `inert` | `boolean` | - | @see [https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/inert](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/inert) |
| `inputMode` | `"text" \| "none" \| "search" \| "url" \| "tel" \| "email" \| "numeric" \| "decimal"` | - | Hints at the type of data that might be entered by the user while editing the element or its contents @see [https://html.spec.whatwg.org/multipage/interaction.html#input-modalities:-the-inputmode-attribute](https://html.spec.whatwg.org/multipage/interaction.html#input-modalities:-the-inputmode-attribute) |
| `is` | `string` | - | Specify that a standard HTML element should behave like a defined custom built-in element @see [https://html.spec.whatwg.org/multipage/custom-elements.html#attr-is](https://html.spec.whatwg.org/multipage/custom-elements.html#attr-is) |
| `exportparts` | `string` | - | @see [https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/exportparts](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/exportparts) |
| `part` | `string` | - | @see [https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/part](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/part) |
| `children` | `ReactNode` | - | - |
| `dangerouslySetInnerHTML` | `{ __html: string \| TrustedHTML; }` | - | - |
| `wrapWith` | `ReactElement<unknown, string \| JSXElementConstructor<any>>` | - | - |

### Events

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `onCopy` | `ClipboardEventHandler<HTMLElement>` | - | - |
| `onCopyCapture` | `ClipboardEventHandler<HTMLElement>` | - | - |
| `onCut` | `ClipboardEventHandler<HTMLElement>` | - | - |
| `onCutCapture` | `ClipboardEventHandler<HTMLElement>` | - | - |
| `onPaste` | `ClipboardEventHandler<HTMLElement>` | - | - |
| `onPasteCapture` | `ClipboardEventHandler<HTMLElement>` | - | - |
| `onCompositionEnd` | `CompositionEventHandler<HTMLElement>` | - | - |
| `onCompositionEndCapture` | `CompositionEventHandler<HTMLElement>` | - | - |
| `onCompositionStart` | `CompositionEventHandler<HTMLElement>` | - | - |
| `onCompositionStartCapture` | `CompositionEventHandler<HTMLElement>` | - | - |
| `onCompositionUpdate` | `CompositionEventHandler<HTMLElement>` | - | - |
| `onCompositionUpdateCapture` | `CompositionEventHandler<HTMLElement>` | - | - |
| `onFocus` | `FocusEventHandler<HTMLElement>` | - | - |
| `onFocusCapture` | `FocusEventHandler<HTMLElement>` | - | - |
| `onBlur` | `FocusEventHandler<HTMLElement>` | - | - |
| `onBlurCapture` | `FocusEventHandler<HTMLElement>` | - | - |
| `onChange` | `ChangeEventHandler<HTMLElement, Element>` | - | - |
| `onChangeCapture` | `ChangeEventHandler<HTMLElement, Element>` | - | - |
| `onBeforeInput` | `InputEventHandler<HTMLElement>` | - | - |
| `onBeforeInputCapture` | `InputEventHandler<HTMLElement>` | - | - |
| `onInput` | `InputEventHandler<HTMLElement>` | - | - |
| `onInputCapture` | `InputEventHandler<HTMLElement>` | - | - |
| `onReset` | `ReactEventHandler<HTMLElement>` | - | - |
| `onResetCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onSubmit` | `SubmitEventHandler<HTMLElement>` | - | - |
| `onSubmitCapture` | `SubmitEventHandler<HTMLElement>` | - | - |
| `onInvalid` | `ReactEventHandler<HTMLElement>` | - | - |
| `onInvalidCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onLoad` | `ReactEventHandler<HTMLElement>` | - | - |
| `onLoadCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onError` | `ReactEventHandler<HTMLElement>` | - | - |
| `onErrorCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onKeyDown` | `KeyboardEventHandler<HTMLElement>` | - | - |
| `onKeyDownCapture` | `KeyboardEventHandler<HTMLElement>` | - | - |
| `onKeyPress` _(deprecated)_ | `KeyboardEventHandler<HTMLElement>` | - | @deprecated Use `onKeyUp` or `onKeyDown` instead |
| `onKeyPressCapture` _(deprecated)_ | `KeyboardEventHandler<HTMLElement>` | - | @deprecated Use `onKeyUpCapture` or `onKeyDownCapture` instead |
| `onKeyUp` | `KeyboardEventHandler<HTMLElement>` | - | - |
| `onKeyUpCapture` | `KeyboardEventHandler<HTMLElement>` | - | - |
| `onAbort` | `ReactEventHandler<HTMLElement>` | - | - |
| `onAbortCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onCanPlay` | `ReactEventHandler<HTMLElement>` | - | - |
| `onCanPlayCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onCanPlayThrough` | `ReactEventHandler<HTMLElement>` | - | - |
| `onCanPlayThroughCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onDurationChange` | `ReactEventHandler<HTMLElement>` | - | - |
| `onDurationChangeCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onEmptied` | `ReactEventHandler<HTMLElement>` | - | - |
| `onEmptiedCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onEncrypted` | `ReactEventHandler<HTMLElement>` | - | - |
| `onEncryptedCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onEnded` | `ReactEventHandler<HTMLElement>` | - | - |
| `onEndedCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onLoadedData` | `ReactEventHandler<HTMLElement>` | - | - |
| `onLoadedDataCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onLoadedMetadata` | `ReactEventHandler<HTMLElement>` | - | - |
| `onLoadedMetadataCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onLoadStart` | `ReactEventHandler<HTMLElement>` | - | - |
| `onLoadStartCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onPause` | `ReactEventHandler<HTMLElement>` | - | - |
| `onPauseCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onPlay` | `ReactEventHandler<HTMLElement>` | - | - |
| `onPlayCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onPlaying` | `ReactEventHandler<HTMLElement>` | - | - |
| `onPlayingCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onProgress` | `ReactEventHandler<HTMLElement>` | - | - |
| `onProgressCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onRateChange` | `ReactEventHandler<HTMLElement>` | - | - |
| `onRateChangeCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onSeeked` | `ReactEventHandler<HTMLElement>` | - | - |
| `onSeekedCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onSeeking` | `ReactEventHandler<HTMLElement>` | - | - |
| `onSeekingCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onStalled` | `ReactEventHandler<HTMLElement>` | - | - |
| `onStalledCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onSuspend` | `ReactEventHandler<HTMLElement>` | - | - |
| `onSuspendCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onTimeUpdate` | `ReactEventHandler<HTMLElement>` | - | - |
| `onTimeUpdateCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onVolumeChange` | `ReactEventHandler<HTMLElement>` | - | - |
| `onVolumeChangeCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onWaiting` | `ReactEventHandler<HTMLElement>` | - | - |
| `onWaitingCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onAuxClick` | `MouseEventHandler<HTMLElement>` | - | - |
| `onAuxClickCapture` | `MouseEventHandler<HTMLElement>` | - | - |
| `onClick` | `MouseEventHandler<HTMLElement>` | - | - |
| `onClickCapture` | `MouseEventHandler<HTMLElement>` | - | - |
| `onContextMenu` | `MouseEventHandler<HTMLElement>` | - | - |
| `onContextMenuCapture` | `MouseEventHandler<HTMLElement>` | - | - |
| `onDoubleClick` | `MouseEventHandler<HTMLElement>` | - | - |
| `onDoubleClickCapture` | `MouseEventHandler<HTMLElement>` | - | - |
| `onDrag` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragCapture` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragEnd` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragEndCapture` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragEnter` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragEnterCapture` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragExit` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragExitCapture` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragLeave` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragLeaveCapture` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragOver` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragOverCapture` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragStart` | `DragEventHandler<HTMLElement>` | - | - |
| `onDragStartCapture` | `DragEventHandler<HTMLElement>` | - | - |
| `onDrop` | `DragEventHandler<HTMLElement>` | - | - |
| `onDropCapture` | `DragEventHandler<HTMLElement>` | - | - |
| `onMouseDown` | `MouseEventHandler<HTMLElement>` | - | - |
| `onMouseDownCapture` | `MouseEventHandler<HTMLElement>` | - | - |
| `onMouseEnter` | `MouseEventHandler<HTMLElement>` | - | - |
| `onMouseLeave` | `MouseEventHandler<HTMLElement>` | - | - |
| `onMouseMove` | `MouseEventHandler<HTMLElement>` | - | - |
| `onMouseMoveCapture` | `MouseEventHandler<HTMLElement>` | - | - |
| `onMouseOut` | `MouseEventHandler<HTMLElement>` | - | - |
| `onMouseOutCapture` | `MouseEventHandler<HTMLElement>` | - | - |
| `onMouseOver` | `MouseEventHandler<HTMLElement>` | - | - |
| `onMouseOverCapture` | `MouseEventHandler<HTMLElement>` | - | - |
| `onMouseUp` | `MouseEventHandler<HTMLElement>` | - | - |
| `onMouseUpCapture` | `MouseEventHandler<HTMLElement>` | - | - |
| `onSelect` | `ReactEventHandler<HTMLElement>` | - | - |
| `onSelectCapture` | `ReactEventHandler<HTMLElement>` | - | - |
| `onTouchCancel` | `TouchEventHandler<HTMLElement>` | - | - |
| `onTouchCancelCapture` | `TouchEventHandler<HTMLElement>` | - | - |
| `onTouchEnd` | `TouchEventHandler<HTMLElement>` | - | - |
| `onTouchEndCapture` | `TouchEventHandler<HTMLElement>` | - | - |
| `onTouchMove` | `TouchEventHandler<HTMLElement>` | - | - |
| `onTouchMoveCapture` | `TouchEventHandler<HTMLElement>` | - | - |
| `onTouchStart` | `TouchEventHandler<HTMLElement>` | - | - |
| `onTouchStartCapture` | `TouchEventHandler<HTMLElement>` | - | - |
| `onPointerDown` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerDownCapture` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerMove` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerMoveCapture` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerUp` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerUpCapture` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerCancel` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerCancelCapture` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerEnter` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerLeave` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerOver` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerOverCapture` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerOut` | `PointerEventHandler<HTMLElement>` | - | - |
| `onPointerOutCapture` | `PointerEventHandler<HTMLElement>` | - | - |
| `onGotPointerCapture` | `PointerEventHandler<HTMLElement>` | - | - |
| `onGotPointerCaptureCapture` | `PointerEventHandler<HTMLElement>` | - | - |
| `onLostPointerCapture` | `PointerEventHandler<HTMLElement>` | - | - |
| `onLostPointerCaptureCapture` | `PointerEventHandler<HTMLElement>` | - | - |
| `onScroll` | `UIEventHandler<HTMLElement>` | - | - |
| `onScrollCapture` | `UIEventHandler<HTMLElement>` | - | - |
| `onScrollEnd` | `UIEventHandler<HTMLElement>` | - | - |
| `onScrollEndCapture` | `UIEventHandler<HTMLElement>` | - | - |
| `onWheel` | `WheelEventHandler<HTMLElement>` | - | - |
| `onWheelCapture` | `WheelEventHandler<HTMLElement>` | - | - |
| `onAnimationStart` | `AnimationEventHandler<HTMLElement>` | - | - |
| `onAnimationStartCapture` | `AnimationEventHandler<HTMLElement>` | - | - |
| `onAnimationEnd` | `AnimationEventHandler<HTMLElement>` | - | - |
| `onAnimationEndCapture` | `AnimationEventHandler<HTMLElement>` | - | - |
| `onAnimationIteration` | `AnimationEventHandler<HTMLElement>` | - | - |
| `onAnimationIterationCapture` | `AnimationEventHandler<HTMLElement>` | - | - |
| `onToggle` | `ToggleEventHandler<HTMLElement>` | - | - |
| `onBeforeToggle` | `ToggleEventHandler<HTMLElement>` | - | - |
| `onTransitionCancel` | `TransitionEventHandler<HTMLElement>` | - | - |
| `onTransitionCancelCapture` | `TransitionEventHandler<HTMLElement>` | - | - |
| `onTransitionEnd` | `TransitionEventHandler<HTMLElement>` | - | - |
| `onTransitionEndCapture` | `TransitionEventHandler<HTMLElement>` | - | - |
| `onTransitionRun` | `TransitionEventHandler<HTMLElement>` | - | - |
| `onTransitionRunCapture` | `TransitionEventHandler<HTMLElement>` | - | - |
| `onTransitionStart` | `TransitionEventHandler<HTMLElement>` | - | - |
| `onTransitionStartCapture` | `TransitionEventHandler<HTMLElement>` | - | - |

### Accessibility

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `aria-activedescendant` | `string` | - | Identifies the currently active element when DOM focus is on a composite widget, textbox, group, or application. |
| `aria-atomic` | `Booleanish` | - | Indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute. |
| `aria-autocomplete` | `"list" \| "none" \| "inline" \| "both"` | - | Indicates whether inputting text could trigger display of one or more predictions of the user's intended value for an input and specifies how predictions would be presented if they are made. |
| `aria-braillelabel` | `string` | - | Defines a string value that labels the current element, which is intended to be converted into Braille. @see aria-label. |
| `aria-brailleroledescription` | `string` | - | Defines a human-readable, author-localized abbreviated description for the role of an element, which is intended to be converted into Braille. @see aria-roledescription. |
| `aria-busy` | `Booleanish` | - | - |
| `aria-checked` | `boolean \| "false" \| "true" \| "mixed"` | - | Indicates the current "checked" state of checkboxes, radio buttons, and other widgets. @see aria-pressed @see aria-selected. |
| `aria-colcount` | `number` | - | Defines the total number of columns in a table, grid, or treegrid. @see aria-colindex. |
| `aria-colindex` | `number` | - | Defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid. @see aria-colcount @see aria-colspan. |
| `aria-colindextext` | `string` | - | Defines a human readable text alternative of aria-colindex. @see aria-rowindextext. |
| `aria-colspan` | `number` | - | Defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid. @see aria-colindex @see aria-rowspan. |
| `aria-controls` | `string` | - | Identifies the element (or elements) whose contents or presence are controlled by the current element. @see aria-owns. |
| `aria-current` | `boolean \| "step" \| "false" \| "true" \| "page" \| "location" \| "date" \| "time"` | - | Indicates the element that represents the current item within a container or set of related elements. |
| `aria-describedby` | `string` | - | Identifies the element (or elements) that describes the object. @see aria-labelledby |
| `aria-description` | `string` | - | Defines a string value that describes or annotates the current element. @see related aria-describedby. |
| `aria-details` | `string` | - | Identifies the element that provides a detailed, extended description for the object. @see aria-describedby. |
| `aria-disabled` | `Booleanish` | - | Indicates that the element is perceivable but disabled, so it is not editable or otherwise operable. @see aria-hidden @see aria-readonly. |
| `aria-dropeffect` _(deprecated)_ | `"none" \| "link" \| "copy" \| "execute" \| "move" \| "popup"` | - | Indicates what functions can be performed when a dragged object is released on the drop target. @deprecated in ARIA 1.1 |
| `aria-errormessage` | `string` | - | Identifies the element that provides an error message for the object. @see aria-invalid @see aria-describedby. |
| `aria-expanded` | `Booleanish` | - | Indicates whether the element, or another grouping element it controls, is currently expanded or collapsed. |
| `aria-flowto` | `string` | - | Identifies the next element (or elements) in an alternate reading order of content which, at the user's discretion, allows assistive technology to override the general default of reading in document source order. |
| `aria-grabbed` _(deprecated)_ | `Booleanish` | - | Indicates an element's "grabbed" state in a drag-and-drop operation. @deprecated in ARIA 1.1 |
| `aria-haspopup` | `boolean \| "false" \| "true" \| "menu" \| "listbox" \| "tree" \| "grid" \| "dialog"` | - | Indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element. |
| `aria-hidden` | `Booleanish` | - | Indicates whether the element is exposed to an accessibility API. @see aria-disabled. |
| `aria-invalid` | `boolean \| "false" \| "true" \| "grammar" \| "spelling"` | - | Indicates the entered value does not conform to the format expected by the application. @see aria-errormessage. |
| `aria-keyshortcuts` | `string` | - | Indicates keyboard shortcuts that an author has implemented to activate or give focus to an element. |
| `aria-label` | `string` | - | Defines a string value that labels the current element. @see aria-labelledby. |
| `aria-labelledby` | `string` | - | Identifies the element (or elements) that labels the current element. @see aria-describedby. |
| `aria-level` | `number` | - | Defines the hierarchical level of an element within a structure. |
| `aria-live` | `"off" \| "assertive" \| "polite"` | - | Indicates that an element will be updated, and describes the types of updates the user agents, assistive technologies, and user can expect from the live region. |
| `aria-modal` | `Booleanish` | - | Indicates whether an element is modal when displayed. |
| `aria-multiline` | `Booleanish` | - | Indicates whether a text box accepts multiple lines of input or only a single line. |
| `aria-multiselectable` | `Booleanish` | - | Indicates that the user may select more than one item from the current selectable descendants. |
| `aria-orientation` | `"horizontal" \| "vertical"` | - | Indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous. |
| `aria-owns` | `string` | - | Identifies an element (or elements) in order to define a visual, functional, or contextual parent/child relationship between DOM elements where the DOM hierarchy cannot be used to represent the relationship. @see aria-controls. |
| `aria-placeholder` | `string` | - | Defines a short hint (a word or short phrase) intended to aid the user with data entry when the control has no value. A hint could be a sample value or a brief description of the expected format. |
| `aria-posinset` | `number` | - | Defines an element's number or position in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM. @see aria-setsize. |
| `aria-pressed` | `boolean \| "false" \| "true" \| "mixed"` | - | Indicates the current "pressed" state of toggle buttons. @see aria-checked @see aria-selected. |
| `aria-readonly` | `Booleanish` | - | Indicates that the element is not editable, but is otherwise operable. @see aria-disabled. |
| `aria-relevant` | `"text" \| "additions" \| "additions removals" \| "additions text" \| "all" \| "removals" \| "removals additions" \| "removals text" \| "text additions" \| "text removals"` | - | Indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified. @see aria-atomic. |
| `aria-required` | `Booleanish` | - | Indicates that user input is required on the element before a form may be submitted. |
| `aria-roledescription` | `string` | - | Defines a human-readable, author-localized description for the role of an element. |
| `aria-rowcount` | `number` | - | Defines the total number of rows in a table, grid, or treegrid. @see aria-rowindex. |
| `aria-rowindex` | `number` | - | Defines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid. @see aria-rowcount @see aria-rowspan. |
| `aria-rowindextext` | `string` | - | Defines a human readable text alternative of aria-rowindex. @see aria-colindextext. |
| `aria-rowspan` | `number` | - | Defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid. @see aria-rowindex @see aria-colspan. |
| `aria-selected` | `Booleanish` | - | Indicates the current "selected" state of various widgets. @see aria-checked @see aria-pressed. |
| `aria-setsize` | `number` | - | Defines the number of items in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM. @see aria-posinset. |
| `aria-sort` | `"none" \| "ascending" \| "descending" \| "other"` | - | Indicates if items in a table or grid are sorted in ascending or descending order. |
| `aria-valuemax` | `number` | - | Defines the maximum allowed value for a range widget. |
| `aria-valuemin` | `number` | - | Defines the minimum allowed value for a range widget. |
| `aria-valuenow` | `number` | - | Defines the current value for a range widget. @see aria-valuetext. |
| `aria-valuetext` | `string` | - | Defines the human readable text alternative of aria-valuenow for a range widget. |


## Guidelines

# Grundlagen

Sections sind ein häufiger Bestandteil komplexerer Components, die von dieser
strukturellen Eigenschaft profitieren. Außerdem bilden sie einen grundlegenden
Baustein, um Oberflächen aufzubauen (siehe
[Content strukturieren](/03-patterns/01-patterns/detail-page)).

## Best practices

Achte bei der Verwendung einer Section darauf, dass ...

- sie eine kurze, aussagekräftige
  [Heading](/04-components/content/heading/overview) erhält.
- bei Bedarf ein [Switch](/04-components/form-controls/switch/overview), ein
  [Link](/04-components/navigations/link/overview) oder bis zu zwei
  [Buttons](/04-components/actions/button/overview) oben in die SectionAction
  integriert werden können.
- bei mehreren Sections die wichtigste ganz oben steht.

## Verwendung

Verwende eine Section, um...

- Content in kleinere Teilbereiche zu gliedern und so die Übersichtlichkeit zu
  erhöhen.
- einzelne Teilbereiche automatisch durch einen
  [Separator](/04-components/structure/separator/overview) zu trennen, wenn
  mehrere Sections eingesetzt werden.
- Elemente vertikal zu positionieren und die korrekten Abstände sicherzustellen.
  Für horizontale Positionierungen eignet sich ein
  [ColumnLayout](/04-components/structure/column-layout/overview).

---

# Anwendung

## Abstände

Die Section sorgt automatisch für Abstände zwischen den darin platzierten
Elementen. Aufeinanderfolgende Sections werden zusätzlich durch einen
[Separator](/04-components/structure/separator/overview) getrennt. Dadurch
entsteht eine klare visuelle Struktur und Hierarchie für den Content.

Innerhalb einer Section mit einer
H2-[Heading](/04-components/content/heading/overview) kann durch weitere
H3-Headings eine Sub-Heading-Struktur aufgebaut werden. Zwischen diesen
Sub-Inhalten erscheint kein Separator, sondern sie werden durch einen größeren
Abstand optisch voneinander getrennt.

## Position

Sections werden häufig im Content-Bereich verwendet und füllen dort die gesamte
Breite aus. Wenn mehrere Sections untereinander verwendet werden, achte auf
folgende Punkte:

- Die Section mit dem wichtigsten Inhalt sollte ganz oben stehen, insbesondere
  Sections mit [AlertBadge](/04-components/status/alert-badge/overview),
  [Badges](/04-components/status/badge/overview) oder Actions (z. B.
  [Buttons](/04-components/actions/button/overview)).
- Vermeide zu viele Sections, um den User nicht zu überladen. Überlege, ob der
  Content in solchen Fällen auf mehrere Seiten oder
  [Tabs](/04-components/navigation/tabs/overview) verteilt werden sollte.

## Hierarchie

Eine Section beginnt immer mit einer
[Heading](/04-components/content/heading/overview). Darauf folgt der eigentliche
Content – also Informationen in Form von beispielsweise
[LabeledValues](/04-components/content/labeled-value/overview) oder einfachem
Text. Im unteren Bereich der Section bilden häufig
[Links](/04-components/navigation/link/overview) und
[Buttons](/04-components/actions/button/overview) den Abschluss. Im
Header-Bereich, in der sogenannten SectionAction, können prominentere Buttons
und Links platziert werden.

**✅ Do**

Erzeuge eine klare und sinnvolle Struktur innerhalb der Section.

```tsx
import {
  Heading,
  IconStar,
  Link,
  Section,
  Text,
} from "@mittwald/flow-react-components";

<Section>
  <Heading>
    <IconStar />
    Erste Schritte
  </Heading>
  <Text>
    Im Onboarding erklären wir dir alles Wichtige – etwa die
    Organisationsstrukturen deines Hostings, das Rechte- und
    Rollensystem oder auch den Zugang über SSH.
  </Text>
  <Link href="#">Starten</Link>
</Section>
```

---

# Inhalt

## SectionAction und AlertBadge/Badge

Durch den SectionAction-Bereich im Header sowie den AlertBadge bzw. Badge lassen
sich Informationen und Interaktionen kompakt darstellen. Achte bei der
Verwendung dieser Elemente darauf, dass ...

- [AlertBadge](/04-components/status/alert-badge/overview),
  [Badges](/04-components/status/badge/overview) und Actions sich immer
  unmittelbar auf die Section beziehen, der sie zugeordnet sind.
- Die Hauptaktion der Section sich deutlich von anderen Aktionen abhebt. Dies
  gilt insbesondere, wenn 2 oder mehr Aktionen verwendet werden.

**✅ Do**

Der AlertBadge bezieht sich auf den Status der Section, der er zugeordnet ist.
  Die Hauptaktion der Section ist deutlich hervorgehoben und dauerhaft sichtbar,
  obwohl es mehrere Actions gibt.

```tsx
import {
  AlertBadge,
  Button,
  ColumnLayout,
  Content,
  CopyButton,
  Header,
  Heading,
  IconExternalLink,
  Label,
  LabeledValue,
  Link,
  Section,
  Text,
} from "@mittwald/flow-react-components";

<Section>
  <Header>
    <Heading>
      Mein Projekt
      <AlertBadge status="danger">Deaktiviert</AlertBadge>
    </Heading>

    <Button variant="soft" color="secondary">
      Datenbank migrieren
    </Button>
    <Button color="accent">Aktivieren</Button>
  </Header>

  <ColumnLayout>
    <LabeledValue>
      <Label>Projektname</Label>
      <Content>Dolce Vita</Content>
    </LabeledValue>
    <LabeledValue>
      <Label>Short-ID</Label>
      <Content>p-lol3qe</Content>
      <CopyButton text="p-lol3qe" />
    </LabeledValue>
    <LabeledValue>
      <Label>Projektdomain</Label>
      <Link>
        <Text>p-lol3qe.project.space</Text>
        <IconExternalLink />
      </Link>
      <CopyButton text="p-lol3qe.project.space" />
    </LabeledValue>
  </ColumnLayout>
</Section>
```

**⛔️ Don't**

Der AlertBadge sollte sich nicht auf Dinge beziehen, die außerhalb der Section
  liegen. Außerdem sollte die Hauptaktion immer sichtbar sein.

```tsx
import {
  AlertBadge,
  Button,
  ColumnLayout,
  Content,
  CopyButton,
  Header,
  Heading,
  IconContextMenu,
  IconExternalLink,
  Label,
  LabeledValue,
  Link,
  Section,
  Text,
} from "@mittwald/flow-react-components";

<Section>
  <Header>
    <Heading>
      Mein Projekt
      <AlertBadge status="danger">
        Fehlende Vertragspartnerdaten
      </AlertBadge>
    </Heading>
    <Button
      variant="soft"
      color="secondary"
      aria-label="Weitere Aktionen anzeigen"
    >
      <IconContextMenu />
    </Button>
    <Button variant="soft" color="secondary">
      Datenbank migrieren
    </Button>
  </Header>

  <ColumnLayout>
    <LabeledValue>
      <Label>Projektname</Label>
      <Content>Dolce Vita</Content>
    </LabeledValue>
    <LabeledValue>
      <Label>Short-ID</Label>
      <Content>p-lol3qe</Content>
      <CopyButton text="p-lol3qe" />
    </LabeledValue>
    <LabeledValue>
      <Label>Projektdomain</Label>
      <Link>
        <Text>p-lol3qe.project.space</Text>
        <IconExternalLink />
      </Link>
      <CopyButton text="p-lol3qe.project.space" />
    </LabeledValue>
  </ColumnLayout>
</Section>
```

---

# Verhalten

## Responsive Layout

- Die Section passt sich der Breite des umgebenden Containers an.
- Reicht die Breite der Section nicht aus, um alle Inhalte des Header-Bereichs
  darzustellen, bricht der
  [Switch](/04-components/form-controls/switch/overview) oder brechen die
  [Buttons](/04-components/actions/button/overview) in die nächste Zeile um.
  Dort ordnen sie sich weiterhin an der rechten Seite an.
- Der [AlertBadge](/04-components/status/alert-badge/overview) bleibt immer auf
  einer Höhe mit dem Titel. Ist der Titel zu lang, wird er zweizeilig.

  

**ℹ️ Info**

Wenn die Section nicht alle Inhalte horizontal darstellen kann, springen die
    Actions in die nächste Zeile. Dort ordnen sie sich weiterhin rechts an.

```tsx
import {
  AlertBadge,
  Button,
  ColumnLayout,
  Content,
  CopyButton,
  Header,
  Heading,
  IconExternalLink,
  Label,
  LabeledValue,
  Link,
  Section,
  Text,
} from "@mittwald/flow-react-components";

<Section>
  <Header>
    <Heading>
      Mein Projekt
      <AlertBadge status="danger">Deaktiviert</AlertBadge>
    </Heading>

    <Button variant="soft" color="secondary">
      Datenbank migrieren
    </Button>
    <Button color="accent">Aktivieren</Button>
  </Header>

  <ColumnLayout>
    <LabeledValue>
      <Label>Projektname</Label>
      <Content>Dolce Vita</Content>
    </LabeledValue>
    <LabeledValue>
      <Label>Short-ID</Label>
      <Content>p-lol3qe</Content>
      <CopyButton text="p-lol3qe" />
    </LabeledValue>
    <LabeledValue>
      <Label>Projektdomain</Label>
      <Link>
        <Text>p-lol3qe.project.space</Text>
        <IconExternalLink />
      </Link>
      <CopyButton text="p-lol3qe.project.space" />
    </LabeledValue>
  </ColumnLayout>
</Section>
```

  

**ℹ️ Info**

AlertBadge bzw. Badge und Heading bleiben immer auf einer Höhe. Ist der Text
    zu lang, bricht er in die nächste Zeile um.

```tsx
import {
  AlertBadge,
  Button,
  ColumnLayout,
  Content,
  CopyButton,
  Header,
  Heading,
  IconExternalLink,
  Label,
  LabeledValue,
  Link,
  Section,
  Text,
} from "@mittwald/flow-react-components";

<Section>
  <Header>
    <Heading>
      Mein sehr langes Projekt
      <AlertBadge status="danger">Deaktiviert</AlertBadge>
    </Heading>

    <Button variant="soft" color="secondary">
      Datenbank migrieren
    </Button>
    <Button color="accent">Aktivieren</Button>
  </Header>

  <ColumnLayout>
    <LabeledValue>
      <Label>Projektname</Label>
      <Content>Dolce Vita</Content>
    </LabeledValue>
    <LabeledValue>
      <Label>Short-ID</Label>
      <Content>p-lol3qe</Content>
      <CopyButton text="p-lol3qe" />
    </LabeledValue>
    <LabeledValue>
      <Label>Projektdomain</Label>
      <Link>
        <Text>p-lol3qe.project.space</Text>
        <IconExternalLink />
      </Link>
      <CopyButton text="p-lol3qe.project.space" />
    </LabeledValue>
  </ColumnLayout>
</Section>
```