Khi form Flutter được dùng trên desktop hoặc với bàn phím rời, người dùng cần di chuyển qua các ô bằng Tab. Thứ tự dựng widget và thứ tự nhìn thấy trên màn hình có thể khác nhau. FocusTraversalGroup cho phép áp dụng chính sách di chuyển focus cho một nhóm widget.
Chọn thứ tự cần kiểm tra
Ví dụ đặt hai ô tên và email vào một nhóm có thứ tự số rõ ràng. Dùng MaterialApp và Scaffold của app thử nghiệm để hiển thị widget. Các API trong ví dụ được đối chiếu với tài liệu Flutter tại ngày 19/11/2026, chưa chạy trên thiết bị.
import 'package:flutter/material.dart';
class ContactFields extends StatelessWidget {
const ContactFields({super.key});
@override
Widget build(BuildContext context) {
return FocusTraversalGroup(
policy: OrderedTraversalPolicy(),
child: Column(
children: const [
FocusTraversalOrder(
order: NumericFocusOrder(1),
child: TextField(
decoration: InputDecoration(labelText: 'Tên'),
),
),
FocusTraversalOrder(
order: NumericFocusOrder(2),
child: TextField(
decoration: InputDecoration(labelText: 'Email'),
),
),
],
),
);
}
}
Kiểm tra cả hai chiều
Click ô Tên rồi bấm Tab. Focus cần chuyển đến Email. Bấm Shift+Tab để kiểm tra chiều ngược. Sau đó thử trên kích thước màn hình mà form đổi từ hai cột thành một cột. Thứ tự nên theo tác vụ người dùng đang làm thay vì vị trí còn sót từ bố cục cũ.
Trong widget test, gửi sự kiện bàn phím và pump để framework xử lý thay đổi. Kiểm tra focus thực tế thay vì chỉ xác nhận widget có NumericFocusOrder. Nếu nhóm có nút phụ, quyết định vị trí của nút trong trình tự và thử điều hướng qua nó.
Những điểm dễ bỏ sót
Nhóm mặc định dùng thứ tự đọc. Chỉ định thứ tự rõ khi có nhu cầu về luồng thao tác. Các thứ tự trong cùng chính sách nên có kiểu so sánh tương thích. Nếu kết hợp nhiều nhóm, nhớ rằng nhóm con còn chịu vị trí của nó trong chính sách của nhóm cha.
Nếu tự tạo FocusNode, giữ nó theo vòng đời State và dispose khi không dùng nữa. Không tạo FocusNode mới trong mỗi lần build vì có thể làm mất trạng thái focus khi UI cập nhật. Các TextField trong ví dụ tự quản lý focus node nội bộ.
Đừng suy ra rằng thứ tự Tab đã đúng thì toàn bộ trải nghiệm trợ năng đã hoàn chỉnh. Kiểm tra nhãn, thông báo lỗi và cách trình đọc màn hình duyệt form trong một lượt kiểm thử riêng. Mục tiêu của cấu hình này là làm luồng bàn phím có thể dự đoán khi người dùng đi qua nhóm ô nhập.


