Tooltip
Tooltip показывает пояснение в маленьком окошке — при наведении курсора, нажатии или долгом нажатии. Обычно так объясняют, что делает кнопка или значок.
На сенсорных экранах подсказки применяют редко: нажатие и долгое нажатие там обычно заняты другими действиями. А вот на десктопе, где есть наведение, они на своём месте.
Как добавить
- Щёлкните правой кнопкой по виджету, которому нужна подсказка, выберите Wrap Widget и затем Tooltip.
- Выделите Tooltip и введите текст в Properties Panel > Message > Text.
Настройки
Внешний вид и поведение задаются в панели свойств.
Компонент вместо текста
Иногда подсказке мало текста: нужны картинка, значки, кнопки. Например, при наведении на общий рейтинг товара показать разбивку отзывов по звёздам.
Для этого установите Tooltip Type в Component и выберите нужный компонент.
Чтобы содержимое подсказки менялось, соберите компонент-обёртку, принимающий WidgetBuilder параметром, и используйте его внутри подсказки.
Как это делается:
Способ вызова
На сенсорных экранах подсказка открывается по касанию. Свойство Trigger Mode переключает её на долгое нажатие.
Подсказка по фокусу
Переключатель Show Tooltip on Focus показывает подсказку, когда вложенный виджет получает фокус с клавиатуры. Это важно для доступности: человек, идущий по форме клавишей Tab, увидит пояснение так же, как тот, кто наводит мышь.
Направление
По умолчанию подсказка появляется под виджетом. Свойство Preferred Direction позволяет открыть её Above, Left или Right.
Хвостик
Размер хвостика подсказки задают свойства Tail Width и Tail Length.
Цвет фона
Задаётся свойством Background Color.
Отступ от виджета
Расстояние между подсказкой и виджетом задаётся свойством Offset в панели свойств.
Скругление углов
Свойство Border Radius в панели свойств.
Тень
Свойство Elevation добавляет тень: подсказка приподнимается над интерфейсом и становится заметнее.
Внутренние отступы
Пространство вокруг текста подсказки задаётся свойством Padding.
Задержка перед показом
Wait Duration — сколько подсказка ждёт, прежде чем появиться.
Задержка перед скрытием
Show Duration — сколько подсказка держится на экране после того, как курсор с виджета ушёл. Обычно её ставят в ноль, чтобы подсказка исчезала сразу.