Una descrizione comando è un breve messaggio descrittivo che viene visualizzato vicino a una visualizzazione quando gli utenti premono a lungo la visualizzazione o posizionano il mouse sopra di essa. Questa funzionalità è utile quando l'app utilizza un'icona per rappresentare un'azione o un'informazione per risparmiare spazio nel layout. Questa pagina mostra come aggiungere queste descrizioni comandi su Android 8.0 (livello API 26) e versioni successive.
Alcuni scenari, come quelli delle app di produttività, richiedono un metodo descrittivo per comunicare idee e azioni. Puoi utilizzare le descrizioni comandi per visualizzare un messaggio descrittivo, come mostrato nella Figura 1.
Figura 1. Descrizione comando visualizzata in un'app per Android.
Alcuni widget standard mostrano le descrizioni comandi in base al contenuto delle proprietà title o content description. A partire da Android 8.0, puoi specificare il testo visualizzato nella descrizione comando indipendentemente dal valore di altre proprietà.
Impostare il testo della descrizione comando
Puoi specificare il testo della descrizione comando in una View chiamando il metodo setTooltipText(). Puoi impostare la proprietà tooltipText utilizzando l'attributo XML o l'API corrispondente.
Per specificare il testo della descrizione comando nei file XML, imposta l'attributo android:tooltipText, come mostrato nell'esempio seguente:
<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 puoi utilizzare per recuperare il valore della proprietà tooltipText.
Android visualizza il valore della proprietà tooltipText quando gli utenti posizionano il mouse sopra la visualizzazione o premono a lungo la visualizzazione.