Una descrizione comando è un piccolo messaggio descrittivo che appare accanto a una vista quando gli utenti premono a lungo la vista o vi passano il mouse sopra. Ciò è 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 comando su Android 8.0 (livello API 26) e versioni successive.
Alcuni scenari, come quelli nelle app di produttività, richiedono un metodo descrittivo per comunicare idee e azioni. Puoi utilizzare le descrizioni comando per visualizzare un messaggio descrittivo, come mostrato nella Figura 1.
Alcuni widget standard mostrano descrizioni comando in base ai contenuti delle proprietà title
o content description
. A partire da Android 8.0, puoi specificare il 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
chiamando il
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 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 mostra il valore della proprietà tooltipText
quando gli utenti passano il mouse sopra la vista o la premono a lungo.