Màn hình hỗ trợ thường hiển thị một mã yêu cầu để người dùng gửi cho đội chăm sóc. Nếu dùng Text thông thường, người dùng có thể phải gõ lại mã dài. SelectableText cho phép chọn một chuỗi hiển thị và dùng thao tác sao chép mà không biến nó thành ô nhập có thể sửa.
Đặt một vùng văn bản có thể chọn
Ví dụ nhận mã từ màn hình cha. Nó giữ mã đầy đủ để người dùng có thể chọn chính xác. Đặt widget trong MaterialApp và Scaffold có layout phù hợp của app thử nghiệm.
import 'package:flutter/material.dart';
class SupportReference extends StatelessWidget {
const SupportReference({super.key, required this.reference});
final String reference;
@override
Widget build(BuildContext context) {
return Padding(
padding: const EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
const Text('Mã yêu cầu hỗ trợ'),
SelectableText(
reference,
style: const TextStyle(fontFamily: 'monospace'),
),
],
),
);
}
}
Kiểm tra chuỗi dài và cỡ chữ lớn
Thử mã ngắn, mã dài có dấu gạch nối và trường hợp người dùng tăng cỡ chữ hệ thống. Chọn toàn bộ mã rồi dán vào một nơi kiểm tra để đối chiếu với chuỗi gốc. Nếu mã xuống dòng do layout, xác nhận thao tác copy không làm thay đổi giá trị dữ liệu.
Trên điện thoại, giữ và kéo vùng chọn. Trên desktop, kiểm tra chuột và bàn phím. Nếu vùng văn bản nằm trong màn hình cuộn, thử chọn gần mép vùng hiển thị để phát hiện vấn đề tương tác.
Chọn phạm vi cần hỗ trợ
SelectableText phù hợp cho một chuỗi hoặc đoạn cụ thể. Nếu cần chọn qua nhiều widget Text trong một cây giao diện, xem SelectionArea hoặc SelectableRegion để thiết kế phạm vi chọn chung. Đừng bọc từng mẩu văn bản nhỏ theo cách làm người dùng phải sao chép từng phần của một thông tin liên tục.
Nếu sản phẩm có nút sao chép nhanh, giữ nhãn và thông báo kết quả dễ hiểu. Nút đó có thể bổ sung cho chọn thủ công, đặc biệt khi mã dài. Xác định rõ người dùng đang copy mã thô hay cả nhãn mô tả.
Chú ý dữ liệu được hiển thị
Chỉ hiện phần thông tin mà màn hình cho phép người dùng xem và chia sẻ. Tránh vô tình đưa credential hoặc dữ liệu nội bộ vào mã chẩn đoán. Với trạng thái chưa có mã, hiển thị thông báo riêng thay vì một chuỗi placeholder dễ bị copy nhầm.
Ví dụ được đối chiếu với API Flutter tại ngày 22/11/2026, chưa chạy trên thiết bị trong lượt viết. Kiểm tra gesture, vùng chọn và trợ năng trên các nền tảng sản phẩm hỗ trợ trước khi đưa vào màn hình chính thức.

