Etykiety

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

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.

zrzut ekranu etykietki

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

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.