Il componente Switch
consente agli utenti di passare da uno stato all'altro: selezionato
e deselezionato. Utilizza un'opzione per consentire all'utente di eseguire una delle seguenti operazioni:
- Attiva o disattiva un'impostazione.
- Attiva o disattiva una funzionalità.
- Seleziona un'opzione.
Il componente è composto da due parti: la miniatura e la traccia. Il cursore è la parte dell'opzione che puoi trascinare e il canale è lo sfondo. L'utente può trascinare il cursore verso sinistra o verso destra per modificare lo stato dell'opzione. Possono anche toccare l'opzione per selezionarla e deselezionarla.
Compatibilità delle versioni
Questa implementazione richiede che il valore minSDK del progetto sia impostato sul livello API 21 o superiore.
Dipendenze
Implementare un'opzione
L'esempio seguente è un'implementazione minima del composable Switch
:
Risultati


Creare una miniatura personalizzata
Puoi passare qualsiasi composable per il parametro thumbContent
per creare un'anteprima personalizzata. Di seguito è riportato un esempio di opzione che utilizza un'icona personalizzata per l'anteprima:
Risultati
L'aspetto della casella deselezionata è lo stesso dell'esempio nella sezione precedente. Tuttavia, se questa opzione è selezionata, l'implementazione viene visualizzata come segue:

Utilizzare colori personalizzati
Utilizza il parametro colors
per cambiare il colore del cursore e del pulsante di un'opzione, tenendo conto dell'eventuale attivazione dell'opzione.
Risultati

Punti chiave
Parametri di base:
checked
: lo stato iniziale dell'opzione.onCheckedChange
: un callback chiamato quando cambia lo stato dell'opzione.enabled
: indica se l'opzione è attivata o disattivata.colors
: i colori utilizzati per l'opzione.
Parametri avanzati
thumbContent
: utilizza questa opzione per personalizzare l'aspetto della miniatura quando è selezionata.colors
: utilizza questo parametro per personalizzare il colore della traccia e della miniatura.
Raccolte che contengono questa guida
Questa guida fa parte di queste raccolte di guide rapide selezionate che coprono obiettivi di sviluppo Android più ampi:
