Etykietka to krótki opis, który pojawia się obok widoku, gdy użytkownik go przytrzyma lub najedzie na niego kursorem myszy. Jest to przydatne, gdy aplikacja używa ikony reprezentującej działanie lub informację, by zaoszczędzić miejsce w układzie. Na tej stronie dowiesz się, jak dodawać te etykietki w Androidzie 8.0 (poziom API 26) i nowszych.
Niektóre scenariusze, np. w aplikacjach zwiększających produktywność, wymagają opisowej metody przekazywania pomysłów i działań. Za pomocą etykietek możesz wyświetlić opisowy komunikat, tak jak to widać na Rysunku 1.
Niektóre widżety standardowe wyświetlają etykietki na podstawie zawartości właściwości title
lub content description
. Począwszy od Androida 8.0, możesz określić tekst wyświetlany w etykietce niezależnie od wartości innych właściwości.
Ustawianie tekstu etykietki
Tekst etykietki możesz określić w elemencie View
, wywołując metodę setTooltipText()
. Możesz ustawić właściwość tooltipText
za pomocą odpowiedniego atrybutu XML lub interfejsu API.
Aby określić tekst etykietki w plikach XML, ustaw atrybut android:tooltipText
jak w tym przykładzie:
<android.support.design.widget.FloatingActionButton
android:id="@+id/fab"
android:tooltipText="Send an email" />
Aby określić tekst etykietki w kodzie, użyj metody setTooltipText(CharSequence)
, tak jak w tym przykładzie:
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");
Interfejs API zawiera też metodę getTooltipText()
, która pozwala pobrać wartość właściwości tooltipText
.
Android wyświetla wartość właściwości tooltipText
, gdy użytkownik najedzie myszą na widok lub go przytrzyma.