Descrizioni comandi

Prova il metodo Scrivi
Jetpack Compose è il toolkit consigliato per la UI per Android. Scopri come aggiungere componenti in Compose.
Popup → .

Una descrizione comando è un piccolo messaggio descrittivo che appare accanto a una vista quando gli utenti tieni premuta la vista o passa il mouse sopra la vista. È utile quando la tua app utilizza un'icona per rappresentare un'azione o un'informazione e risparmiare spazio nella layout. In questa pagina viene mostrato come aggiungere queste descrizioni comando su Android 8.0 (livello API). 26) e successive.

Alcuni scenari, come quelli nelle app di produttività, richiedono un metodo descrittivo di comunicare idee e azioni. Puoi utilizzare le descrizioni comando per visualizzare un messaggio descrittivo, come mostrato nella Figura 1.

screenshot della descrizione comando

Figura 1. Descrizione comando visualizzata in un'app per Android.

Alcuni widget standard mostrano descrizioni comando basate sui contenuti di title o content description proprietà. A partire da Android 8.0, puoi specificare testo visualizzato nella descrizione comando a prescindere dal valore delle altre proprietà.

Impostazione del testo della descrizione comando

Puoi specificare il testo della descrizione comando in un View richiamando il metodo Metodo setTooltipText(). Puoi impostare la proprietà tooltipText utilizzando l'API o l'attributo XML corrispondente.

Per specificare il testo della descrizione comando nei file XML, imposta l'attributo android:tooltipText, come mostrato nel seguente esempio:

<android.support.design.widget.FloatingActionButton
        android:id="@+id/fab"
        android:tooltipText="Send an email" />

Per specificare il testo della descrizione comando nel codice, utilizza il metodo setTooltipText(CharSequence), come mostrato nell'esempio seguente:

Kotlin

val fab: FloatingActionButton = findViewById(R.id.fab)
fab.tooltipText = "Send an email"

Java

FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
fab.setTooltipText("Send an email");

L'API include anche un metodo getTooltipText() che che puoi utilizzare per recuperare il valore della proprietà tooltipText.

Android mostra il valore della proprietà tooltipText quando gli utenti passano il mouse sopra passa il mouse sopra la visualizzazione o premi a lungo la visualizzazione.