Jetpack Compose Academy · Lezione

TopAppBar e icone delle azioni

Aggiunga una barra del titolo con azioni.

Lezione 2 di 413 passaggi

TopAppBar e icone delle azioni è una lezione Jetpack Compose Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Jetpack Compose Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Jetpack Compose Academy include 4 lezioni in totale.

La barra del titolo

La striscia in alto con il nome della schermata e le azioni è la TopAppBar. Offre agli utenti un punto di riferimento stabile che indica dove si trovano. 🧭

Una TopAppBar essenziale

Nella sua forma più semplice, una TopAppBar ha bisogno solo di un titolo. La si inserisca nello slot topBar di Scaffold per ottenere una vera intestazione Material.

TopAppBar(
    title = { Text("Inbox") }
)

Il titolo è un Composable

Si noti che title accetta una lambda Composable, non una String. È quindi possibile inserirvi qualsiasi contenuto, anche se di solito è preferibile un singolo Text.

Lo slot navigationIcon

Lo slot iniziale navigationIcon contiene il pulsante Indietro o il pulsante del menu. Si avvolga Icon in un IconButton, così sarà interattivo e avrà le dimensioni corrette.

navigationIcon = {
    IconButton(onClick = { }) {
        Icon(Icons.Default.Menu, "Menu")
    }
}

Lo slot actions

I pulsanti finali vanno nello slot actions. È un RowScope, quindi ogni IconButton aggiunto si allinea ordinatamente sul bordo destro.

actions = {
    IconButton(onClick = { }) {
        Icon(Icons.Default.Search, "Search")
    }
}

Passare sempre contentDescription

Ogni Icon in una barra richiede una contentDescription. Gli screen reader la annunciano, quindi un'icona Search dovrebbe comunicare Search, non rimanere senza descrizione.

Varianti della barra

Material 3 offre CenterAlignedTopAppBar, MediumTopAppBar e LargeTopAppBar. Differiscono solo per dimensione e allineamento del titolo, quindi si scelga quella più adatta al risultato desiderato.

Colorare la barra

Si usi TopAppBarDefaults.topAppBarColors per cambiare il colore del contenitore e del titolo. È preferibile affidarsi ai colori del tema, così la barra rimane coerente in modalità chiara e scura.

colors = TopAppBarDefaults.topAppBarColors(
    containerColor = MaterialTheme.colorScheme.primary
)

Barre comprimibili

Si passi un scrollBehavior e lo si colleghi allo scroll annidato del contenuto per fare in modo che le barre grandi si riducano quando l'utente scorre verso il basso.

Non sovraccaricare la barra

Si limitino le actions a due o tre icone. Si spostino le altre in un menu overflow, così la barra rimane leggibile sui telefoni più piccoli.

Collegarla a Scaffold

La barra vive nello slot topBar di Scaffold, quindi l'area del contenuto si riduce automaticamente e il corpo della schermata non si nasconde mai dietro di essa.

Scaffold(topBar = { TopAppBar(title = { Text("Home") }) }) { p -> }

Verifica rapida

Si aggiunge un IconButton per la ricerca a una TopAppBar. Dove va inserito?

Riepilogo

Una TopAppBar contiene un title, un navigationIcon iniziale e le actions finali. Si descriva ogni icona, si mantenga la barra ordinata e la si inserisca nello slot topBar. ✨

Gratis per iniziare

Impara Kotlin con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi
30
Lezioni
120

Domande Frequenti

La lezione «TopAppBar e icone delle azioni» è gratuita?

Sì — il testo completo di «TopAppBar e icone delle azioni» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Jetpack Compose Academy, passa a CoddyKit PRO. Il corso Jetpack Compose Academy include 4 lezioni in totale.

Cosa imparerò in «TopAppBar e icone delle azioni»?

Aggiunga una barra del titolo con azioni. Eserciti Jetpack Compose Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Jetpack Compose Academy?

Non è richiesta alcuna esperienza precedente. Jetpack Compose Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.

Quanto tempo richiede la lezione «TopAppBar e icone delle azioni»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Jetpack Compose Academy?

Sì. Ogni lezione Jetpack Compose Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Scaffold: lo scheletro della schermata
  2. TopAppBar e icone delle azioni
  3. Barre inferiori e pulsanti Floating Action
  4. Snackbar e SnackbarHostState
← Torna a Jetpack Compose Academy