Điều khiển bộ sưu tập trong Power Apps

Một điều khiển có chứa các điều khiển khác và hiển thị một tập hợp dữ liệu.

Sự miêu tả

Điều khiển Bộ sưu tập có thể hiển thị nhiều bản ghi từ một nguồn dữ liệu và mỗi bản ghi có thể chứa nhiều loại dữ liệu. Ví dụ: sử dụng điều khiển Bộ sưu tập để hiển thị nhiều liên hệ với mỗi mục hiển thị thông tin liên hệ bao gồm tên, địa chỉ và số điện thoại cho mỗi liên hệ.

Mỗi trường dữ liệu sẽ xuất hiện trong một điều khiển riêng biệt bên trong điều khiển Bộ sưu tập. Và bạn có thể cấu hình các điều khiển đó trong mẫu của nó. Mẫu xuất hiện dưới dạng mục đầu tiên bên trong bộ sưu tập:

Ở cạnh trái của điều khiển Bộ sưu tập theo hướng ngang/ngang.
Và ở đầu điều khiển Bộ sưu tập theo hướng dọc/dọc.

Mọi thay đổi bạn thực hiện trong mẫu sẽ được phản ánh xuyên suốt điều khiển Bộ sưu tập.

Mẫu được xác định trước để hiển thị hình ảnh và văn bản trong bộ sưu tập đều sẵn dùng và bộ sưu tập các mục có chiều cao biến đổi.

Giới hạn

Điều khiển bộ sưu tập có những giới hạn sau:

Nếu người dùng cuộn điều khiển Bộ sưu tập chiều cao linh hoạt trước khi tất cả các mục được tải, mục hiện đang trong dạng xem có thể bị đẩy xuống và ra khỏi dạng xem khi tải dữ liệu xong. Để tránh sự cố này, hãy sử dụng điều khiển Thư viện tiêu chuẩn thay vì biến thể Chiều cao linh hoạt.
Các điều khiển sau đây không được hỗ trợ trong bộ sưu tập:
Bạn không thể thêm bộ sưu tập bên trong bộ sưu tập khác nếu bộ sưu tập thứ hai đã nằm trong một bộ sưu tập khác. Mức lồng tối đa là 2.
Kích cỡ Mẫu tối thiểu là một. Điều này có thể khiến các điều khiển trong Bộ sưu tập trôi dạt khỏi các giá trị X hoặc Y dự kiến của chúng, khi bạn không tính đến kích cỡ mẫu.
Nếu bạn tạo một ứng dụng tự động từ dữ liệu, lưu ứng dụng, rồi mở lại, bộ sưu tập duyệt có thể không hiển thị ngay bất kỳ dữ liệu nào. Để giải quyết vấn đề này, hãy nhập ít nhất một ký tự vào hộp tìm kiếm, rồi xóa văn bản bạn đã nhập. Khi đó, bộ sưu tập sẽ hiển thị dữ liệu như mong đợi.
Nếu bộ sưu tập bao gồm điều khiển ComboBox, DatePicker, OnChange Thanh trượt hoặc Chuyển đổi với quy tắc vá cùng một nguồn dữ liệu hoặc bộ sưu tập như bộ sưu tập, điều này có thể dẫn đến hiệu suất không mong muốn hoặc giảm. Điều này là do quy OnChange tắc vá lỗi nguồn dữ liệu của bộ sưu tập có thể tạo ra chu kỳ vá lỗi và tải lại không bao giờ kết thúc. Để tránh vấn đề này, không nên sử dụng quy tắc khi các điều OnChange khiển này được đặt trong bộ sưu tập.

Thuộc tính khóa

Mặc định – Mục hoặc bản ghi từ nguồn dữ liệu sẽ được chọn trong bộ sưu tập khi ứng dụng khởi động.

Mục – Nguồn dữ liệu xuất hiện trong điều khiển như thư viện, danh sách hoặc biểu đồ.

Selected – Mục đã chọn.

Thuộc tính bổ sung

AccessibleLabel – Nhãn của bộ sưu tập (không phải các mục trong đó) cho bộ đọc màn hình. Nên mô tả danh sách các mục là gì.

AllItems – Các mục được tải trong bộ sưu tập. Giá trị này có thể nhỏ hơn số Mục thực tế của nguồn dữ liệu. Có thể tải thêm mục khi cuộn bộ sưu tập. Tất cả Mục cũng chứa điều khiển được dùng trong mỗi mục bộ sưu tập.

AllItemsCount - Số lượng mục được tải trong bộ sưu tập. Giá trị này có thể nhỏ hơn số Mục thực tế của nguồn dữ liệu. Có thể tải thêm mục khi cuộn bộ sưu tập.

BorderColor – Màu của viền điều khiển.

BorderStyle – Viền của điều khiển là Rắn, Nét đứt, Chấm chấm hay Không.

BorderThickness – Độ dày của viền điều khiển.

DelayItemLoading - Trì hoãn tải các mục (hàng) cho đến sau khi màn hình tải lần đầu tiên.

DisplayMode – Điều khiển có cho phép người dùng nhập (Chỉnh sửa) hay không, chỉ hiển thị dữ liệu (Xem) hay bị tắt (Tắt).

Tô – Màu nền của điều khiển.

Chiều cao – Khoảng cách giữa các cạnh trên cùng và dưới của điều khiển.

ItemAccessibleLabel – Nhãn của từng mục bộ sưu tập cho bộ đọc màn hình. Nên mô tả từng mục là gì.

LoadingSpinner (Không có, Điều khiển hoặc Dữ liệu) - Khi Không có, spinner sẽ không được hiển thị. Khi điều khiển | Dữ liệu, công cụ xoay sẽ được hiển thị khi một kết xuất vượt qua xảy ra dẫn đến các hàng trống hiển thị.

LoadingSpinnerColor - Màu tô của vòng quay tải. Mặc định được đặt là BorderColor.

NavigationStep – Khoảng thời gian một bộ sưu tập cuộn nếu thuộc tính ShowNavigation của bộ sưu tập đó được đặt thành true và người dùng chọn mũi tên dẫn hướng ở một trong hai đầu của bộ sưu tập đó.

Có thể chọn – Có thể chọn các mục trong bộ sưu tập hay không. Khi được đặt thành true, bộ đọc màn hình sẽ xác định bộ sưu tập là danh sách có thể chọn. Và bạn chọn một mục bằng cách chọn mục đó. Khi được đặt thành false, bộ đọc màn hình sẽ xác định bộ sưu tập là danh sách thông thường và việc chọn một mục không chọn mục đó.

ShowNavigation – Mũi tên có xuất hiện ở mỗi đầu của bộ sưu tập hay không để người dùng có thể cuộn qua các mục trong bộ sưu tập bằng cách chọn một mũi tên.

ShowScrollbar – Thanh cuộn có xuất hiện khi người dùng di chuột qua bộ sưu tập hay không.

TemplateFill – Màu nền của bộ sưu tập.

TemplatePadding – Khoảng cách giữa các mục trong bộ sưu tập.

TemplateSize – Chiều cao của mẫu cho bộ sưu tập theo hướng dọc/dọc. Hoặc chiều rộng của mẫu cho bộ sưu tập theo hướng ngang/ngang. Kích cỡ tối thiểu là một.

Chuyển tiếp – Hiệu ứng trực quan (Pop, Push hoặc Không có) khi người dùng di chuột qua một mục trong bộ sưu tập.

Hiển thị – Cho dù điều khiển xuất hiện hay bị ẩn.

Chiều rộng – Khoảng cách giữa các cạnh trái và phải của điều khiển.

WrapCount – Số lượng mục hiển thị trên mỗi hàng hoặc cột dựa trên bố trí ngang hoặc dọc.

X – Khoảng cách giữa cạnh trái của điều khiển và cạnh trái của bộ chứa hoặc màn hình mẹ.

Y – Khoảng cách giữa cạnh trên của điều khiển và cạnh trên của bộ chứa hoặc màn hình mẹ.

Filter( DataSource, Công thức )

Reset( Control ) - Đặt lại bộ sưu tập của bạn trở về trạng thái ban đầu. Trạng thái ban đầu bao gồm cuộn đến mục đầu tiên và chọn mục đầu tiên hoặc mặc định nếu có.

Ghi

Điều khiển đặt lại không đệ trình đặt lại tất cả các nhánh con của bộ sưu tập.

Ví dụ

Hiển thị và lọc dữ liệu

Lấy dữ liệu từ người dùng

Hướng dẫn hỗ trợ tiếp cận

Độ tương phản màu

Nếu bấm vào bất kỳ chỗ nào trong mục bộ sưu tập nhằm chọn mục đó, phải có độ tương phản màu phù hợp giữa:

Màu Viền và màu bên ngoài bộ sưu tập (nếu có viền).
Tô và màu bên ngoài bộ sưu tập (nếu không có viền).

AccessibleLabel phải có mặt.

Ghi

Bộ đọc màn hình sẽ thông báo khi các mục trong bộ sưu tập thay đổi. AccessibleLabel cũng được đề cập. Điều này cung cấp ngữ cảnh cho thông báo và thậm chí còn quan trọng hơn khi có nhiều bộ sưu tập trên cùng một màn hình.
Khi một mục bộ sưu tập chứa nhiều điều khiển, hãy sử dụng ItemAccessibleLabel để hiển thị nội dung của các mục bộ sưu tập.
Đặt giá trị có thể chọn thànhtrue nếu bạn muốn người dùng chọn mục bộ sưu tập. Nếu không, hãy đặt giá trị đó thành false.
Khi một mục bộ sưu tập chứa nhiều điều khiển, hãy sử dụng ItemAccessibleLabel để cung cấp tóm tắt nội dung của mục bộ sưu tập.
Có thể chọn được đặt một cách thích hợp, tùy thuộc vào việc người dùng có muốn chọn một mục bộ sưu tập hay không.

Hỗ trợ bàn phím

Cân nhắc việc đặt ShowScrollbar thànhtrue. Trên hầu hết các thiết bị màn hình cảm ứng, thanh cuộn sẽ không hiển thị cho đến khi quá trình cuộn bắt đầu.
Nếu bấm vào vị trí bất kỳ trong mục bộ sưu tập nhằm chọn mục đó, người dùng bàn phím cũng phải có cách để chọn mục bộ sưu tập. Ví dụ: thêm nút có thuộc tính OnSelect được đặt thành Select(Parent).

Ghi

Các điều khiển bên ngoài bộ sưu tập không được coi là theo thứ tự dẫn hướng bàn phím trong bộ sưu tập. Các điều khiển Chỉ mục Tab bên trong bộ sưu tập đều nằm trong phạm vi. Xem thuộc tính trợ năng để tìm hiểu thêm.

Xem thêm

Sử dụng hộp xoay DelayItemLoading và Loading để cải thiện hiệu suất trong Bộ sưu tập

Phản hồi

Trang này có hữu ích không?

Last updated on 2025-10-04