Button

Schaltflächen sind grundlegende Komponenten, mit denen Nutzer eine definierte Aktion auslösen können. Es gibt fünf Arten von Schaltflächen. In der folgenden Tabelle wird das Aussehen der fünf Schaltflächentypen beschrieben und erläutert, wo sie verwendet werden sollten.

Eingeben	Darstellung	Zweck
Ausgefüllt	Einfarbiger Hintergrund mit kontrastierendem Text	Schaltflächen mit hoher Gewichtung Diese werden für primäre Aktionen in einer Anwendung verwendet, z. B. „Senden“ und „Speichern“. Der Schatteneffekt unterstreicht die Wichtigkeit der Schaltfläche.
Ausgemalte Ton in Ton-Farbe	Die Hintergrundfarbe passt sich der Oberfläche an.	Auch für primäre oder wichtige Aktionen. Ausgefüllte Schaltflächen haben mehr visuelles Gewicht und eignen sich für Funktionen wie „In den Einkaufswagen legen“ und „Anmelden“.
Erhöht	Sie heben sich durch einen Schatten ab.	Sie haben eine ähnliche Funktion wie farbliche Schaltflächen. Erhöhen Sie die Erhöhung, damit die Schaltfläche noch besser sichtbar ist.
Umrandet	Hat einen Rahmen ohne Füllung.	Schaltflächen mit mittlerer Betonung, die Aktionen enthalten, die wichtig, aber nicht primär sind. Sie eignen sich gut, um alternative oder sekundäre Aktionen wie „Abbrechen“ oder „Zurück“ anzugeben.
Text	Text ohne Hintergrund oder Rahmen.	Weniger auffällige Schaltflächen, ideal für weniger wichtige Aktionen wie Navigationslinks oder sekundäre Funktionen wie „Weitere Informationen“ oder „Details ansehen“.

Die folgende Abbildung zeigt die fünf Arten von Schaltflächen in Material Design.

Abbildung 1: Die fünf Schaltflächenkomponenten.

API-Oberfläche

• onClick: Die Funktion, die aufgerufen wird, wenn der Nutzer auf die Schaltfläche drückt.
• enabled: Wenn dieser Parameter auf „false“ gesetzt ist, wird die Schaltfläche als nicht verfügbar und inaktiv angezeigt.
• colors: Eine Instanz von ButtonColors, die die Farben der Schaltfläche bestimmt.
• contentPadding: Der Abstand innerhalb der Schaltfläche.

Gefüllte Schaltfläche

Für die Schaltfläche mit Füllung wird die grundlegende Komponente Button verwendet. Standardmäßig ist er mit einer durchgehenden Farbe gefüllt. Das folgende Snippet zeigt, wie die Komponente implementiert wird:

@Composable
fun FilledButtonExample(onClick: () -> Unit) {
    Button(onClick = { onClick() }) {
        Text("Filled")
    }
}
Button.kt

Hinweis :Wenn Sie eine benutzerdefinierte Schaltfläche erstellen möchten, verwenden Sie das Button-Element.

Diese Implementierung sieht so aus:

Abbildung 2: Eine gefüllte Schaltfläche.

Gefüllte Schaltfläche mit Ton

Für die Schaltfläche mit farbigem Hintergrund wird die Komponente FilledTonalButton verwendet. Es ist standardmäßig mit einer Tonfarbe gefüllt.

Das folgende Snippet zeigt, wie die Komponente implementiert wird:

@Composable
fun FilledTonalButtonExample(onClick: () -> Unit) {
    FilledTonalButton(onClick = { onClick() }) {
        Text("Tonal")
    }
}
Button.kt

Diese Implementierung sieht so aus:

Abbildung 3: Eine farblich hervorgehobene Schaltfläche.

Schaltfläche mit Umriss

Für die umrandete Schaltflächenkomponente wird das OutlinedButton-Element verwendet. Standardmäßig ist ein Umriss zu sehen.

Das folgende Snippet zeigt, wie die Komponente implementiert wird:

@Composable
fun OutlinedButtonExample(onClick: () -> Unit) {
    OutlinedButton(onClick = { onClick() }) {
        Text("Outlined")
    }
}
Button.kt

Diese Implementierung sieht so aus:

Abbildung 4: Eine Schaltfläche mit Umriss.

Erhöhte Schaltfläche

Für die Schaltfläche mit erhöhtem Fokus wird das ElevatedButton-Element verwendet. Sie hat standardmäßig einen Schatten, der den Höheneffekt darstellt. Beachten Sie, dass es sich im Grunde um eine umrandete Schaltfläche mit einem Schatten handelt.

Das folgende Snippet zeigt, wie die Komponente implementiert wird:

@Composable
fun ElevatedButtonExample(onClick: () -> Unit) {
    ElevatedButton(onClick = { onClick() }) {
        Text("Elevated")
    }
}
Button.kt

Diese Implementierung sieht so aus:

Abbildung 5 Eine erhöhte Schaltfläche.

Textschaltfläche

Für die Schaltfläche mit Text wird das TextButton-Element verwendet. Bis zum Drücken wird nur Text angezeigt. Sie hat standardmäßig keine durchgehende Füllung oder keinen Umriss.

Das folgende Snippet zeigt, wie die Komponente implementiert wird:

@Composable
fun TextButtonExample(onClick: () -> Unit) {
    TextButton(
        onClick = { onClick() }
    ) {
        Text("Text Button")
    }
}
Button.kt

Diese Implementierung sieht so aus:

Abbildung 6: Eine Textschaltfläche.

Weitere Informationen

• Unverankerte Aktionsschaltfläche
• Material UI-Dokumente