Una descrizione comando è un piccolo messaggio descrittivo che viene visualizzato vicino a una vista quando gli utenti premono a lungo la vista o passano il mouse sopra la vista. Questo è 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 indipendentemente dal valore delle altre proprietà.
Impostazione del testo della descrizione comando
Puoi specificare il testo della descrizione comando in un View
richiamando 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
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 illustrato 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 esercitano una pressione prolungata.