MenüChevron Down
Button Schaltfläche - Docs - Artefact

Button Schaltfläche

Forms
Intelligente Auto-Erkennung

Einführung

Eine klickbare Komponente zum Auslösen von Aktionen und Benutzerinteraktionen. Umfasst Varianten für Symbole und gruppierte Schaltflächen.

Verwendung

Einfache Schaltfläche

import { Button } from "../components/ui";

export default function MyPage() {
  return (
    <Button variant="solid" colorPalette="blue">
      Click me
    </Button>
  );
}

Ladezustand

import { Button } from "../components/ui";

export default function MyPage() {
  return (
    <Button loading loadingText="Saving...">
      Save
    </Button>
  );
}

Symbol-Schaltfläche

Eine für Symbole optimierte Schaltfläche.

import { IconButton } from "../components/ui";
import { SearchIcon } from "./icons";

export default function MyPage() {
  return (
    <IconButton aria-label="Search">
      <SearchIcon />
    </IconButton>
  );
}

Schließen-Schaltfläche

Eine vorformatierte Schaltfläche zum Schließen von Elementen.

import { CloseButton } from "../components/ui";

export default function MyPage() {
  return <CloseButton onClick={() => console.log("closed")} interactive />;
}

Schaltflächengruppe

import { Button, ButtonGroup } from "../components/ui";

export default function MyPage() {
  return (
    <ButtonGroup attached>
      <Button>First</Button>
      <Button>Second</Button>
    </ButtonGroup>
  );
}

CMS-Seitenbauer

Diese Komponente ist als button-Block im Seitenbauer (content/pages/*.json) verfügbar:

{
  "type": "button",
  "text": "Click me",
  "variant": "solid",
  "colorPalette": "blue"
}

Eigenschaften

Schaltfläche

EigenschaftTypBeschreibung
childrenanyInhalt, der innerhalb der Komponente gerendert wird.
classstringBenutzerdefinierte CSS-Klassen.

| variant | "solid" | "surface" | "subtle" | "outline" | "plain" | Der visuelle Stil der Schaltfläche. |

| size | "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | Die Größe der Schaltfläche. |

| loading | boolean | Wenn true, zeigt die Schaltfläche einen Ladespinner an. | | loadingText | string | Der während des Ladevorgangs angezeigte Text. |

| type | "button" | "submit" | "reset" | Der HTML-Schaltflächentyp. |

| colorPalette | string | Das Farbschema der Schaltfläche. | | interactive | boolean | Legt fest, ob die clientseitige Hydration aktiviert wird. |

Schaltflächengruppe

EigenschaftTypBeschreibung
childrenanyZu gruppierende Schaltflächen.
attachedbooleanLegt fest, ob die Schaltflächen aneinandergehängt werden.