Подсказка — это небольшое описательное сообщение, которое появляется рядом с представлением при длительном нажатии на него или наведении на него указателя мыши. Это полезно, когда ваше приложение использует значок для обозначения действия или информации, чтобы сэкономить место в макете. На этой странице показано, как добавить такие подсказки на Android 8.0 (уровень API 26) и выше.
В некоторых сценариях, например, в приложениях для повышения производительности, требуется описательный метод передачи идей и действий. Вы можете использовать всплывающие подсказки для отображения описательного сообщения, как показано на рисунке 1.
Рисунок 1. Подсказка, отображаемая в приложении Android.
Некоторые стандартные виджеты отображают всплывающие подсказки на основе содержимого свойств title
или content description
. Начиная с Android 8.0, можно указать текст, отображаемый во всплывающей подсказке, независимо от значений других свойств.
Настройка текста подсказки
Вы можете задать текст подсказки в View
, вызвав метод setTooltipText()
. Свойство tooltipText
можно задать, используя соответствующий атрибут XML или API.
Чтобы указать текст всплывающей подсказки в XML-файлах, установите атрибут android:tooltipText
, как показано в следующем примере:
<android.support.design.widget.FloatingActionButton
android:id="@+id/fab"
android:tooltipText="Send an email" />
Чтобы указать текст подсказки в коде, используйте метод setTooltipText(CharSequence)
, как показано в следующем примере:
Котлин
val fab: FloatingActionButton = findViewById(R.id.fab) fab.tooltipText = "Send an email"
Ява
FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab); fab.setTooltipText("Send an email");
API также включает метод getTooltipText()
, который можно использовать для получения значения свойства tooltipText
.
Android отображает значение свойства tooltipText
, когда пользователь наводит указатель мыши на представление или долго нажимает на представление.