Một biểu tượng tải xuống có thể rõ với người viết app nhưng khó hiểu khi xuất hiện cạnh nhiều nút khác. Tooltip bổ sung nhãn mô tả hành động khi người dùng giữ hoặc rê chuột theo cơ chế widget. Với IconButton, Flutter đã có thuộc tính tooltip để đưa thông tin vào cùng component.
Đặt nhãn theo hành động
Ví dụ nhận callback từ màn hình cha. Nhãn nói rõ thao tác tải báo cáo thay vì chỉ mô tả hình mũi tên. Đặt widget trong MaterialApp và Scaffold của app thử nghiệm.
import 'package:flutter/material.dart';
class DownloadReportButton extends StatelessWidget {
const DownloadReportButton({super.key, required this.onDownload});
final VoidCallback onDownload;
@override
Widget build(BuildContext context) {
return IconButton(
tooltip: 'Tải báo cáo',
onPressed: onDownload,
icon: const Icon(Icons.download),
);
}
}
Nếu dùng một widget tùy chỉnh không có thuộc tính tooltip, bọc nó bằng Tooltip với message phù hợp. Kiểm tra widget con vẫn có vùng tương tác và vai trò trợ năng đúng. Tooltip chỉ bổ sung nhãn, không tự biến một hình trang trí thành nút có hành vi đầy đủ.
Kiểm tra cảm ứng, chuột và trợ năng
Trên điện thoại, giữ nút để kiểm tra thông báo xuất hiện. Trên desktop, rê chuột và thử thao tác bàn phím. Dùng trình đọc màn hình để nghe nhãn và xác nhận không có hai nhãn giống nhau bị lặp. Nếu đã gắn Semantics riêng, rà cách nhãn được hợp nhất trước khi thêm thông tin mới.
Kiểm tra ngôn ngữ của ứng dụng. Dùng hệ thống localization để dịch message cùng các chuỗi giao diện khác. Tránh hardcode nhãn vào widget dùng chung nếu sản phẩm hỗ trợ nhiều locale. Khi callback bị vô hiệu hóa do chưa có dữ liệu, xác định cách người dùng hiểu lý do nút không dùng được.
Giữ nội dung ngắn và đúng ngữ cảnh
Tooltip phù hợp cho tên hành động hoặc gợi ý rất ngắn. Hướng dẫn quan trọng để hoàn thành tác vụ nên có vị trí dễ nhìn trên màn hình. Nếu người dùng buộc phải giữ từng nút để đoán bước tiếp theo, bố cục và nhãn chính cần được xem lại.
Khi thêm phân tích thao tác, kiểm tra callback chỉ chạy khi kích hoạt nút theo ý định. Mở tooltip để đọc nhãn không nên vô tình tải báo cáo. Thử cả việc bấm nhanh sau khi tooltip vừa hiện.
Ví dụ đã được đối chiếu với API Flutter tại ngày 21/11/2026, chưa chạy trên thiết bị trong lượt viết. Khi tích hợp, ghi lại nền tảng và SDK đã kiểm tra cùng các ca tương tác nêu trên.

