Etykiety

Wypróbuj sposób tworzenia wiadomości
Jetpack Compose to zalecany zestaw narzędzi UI na Androida. Dowiedz się, jak dodawać komponenty w narzędziu Compose

Etykietka to krótki opis, który wyświetla się obok widoku, gdy użytkownik długo naciśnie go lub najedzie na niego myszą. Jest to przydatne, gdy aplikacja wykorzystuje ikonę reprezentującą działanie lub informację, co pozwala zaoszczędzić miejsce na układzie. Z tej strony dowiesz się, jak dodawać te etykietki w Androidzie 8.0 (poziom interfejsu API 26) i nowszych.

Niektóre scenariusze, np. w aplikacjach zwiększających produktywność, wymagają opisowej metody przekazywania pomysłów i działań. Możesz użyć etykiet, aby wyświetlić opisowy komunikat, tak jak na ilustracji 1.

zrzut ekranu etykietki

Rysunek 1. Etykietka wyświetlana w aplikacji na Androida.

Niektóre standardowe widżety 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 na etykietce niezależnie od wartości innych właściwości.

Ustawianie tekstu etykietki

Możesz określić tekst etykietki w elemencie View, wywołując metodę setTooltipText(). Możesz ustawić właściwość tooltipText za pomocą odpowiedniego atrybutu XML lub interfejsu API.

Aby podać tekst etykietki w plikach XML, ustaw atrybut android:tooltipText w następujący sposób:

<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), jak pokazano 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 również metodę getTooltipText(), za pomocą której można pobierać wartość właściwości tooltipText.

Android wyświetla wartość właściwości tooltipText, gdy użytkownik najedzie kursorem na widok lub przytrzyma go.