Tùy chọn kiểm soát thư viện trong Power Apps
Tùy chọn kiểm soát có chứa các tùy chọn kiểm soát khác và hiển thị tập dữ liệu.
Mô tả
Kiểm soát Thư viện có thể hiển thị nhiều bản ghi từ một nguồn dữ liệu, mỗi bản ghi có thể chứa nhiều loại dữ liệu. Ví dụ: sử dụng tùy chọn kiểm soát 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 xuất hiện trong một tùy chọn kiểm soát riêng thuộc tùy chọn kiểm soát Bộ sưu tập. Bạn có thể đặt cấu hình các tùy chọn kiểm soát đó trong mẫu. Mẫu hiển thị là mục đầu tiên bên trong bộ sưu tập:
- Ở cạnh trái của tùy chọn kiểm soát Bộ sưu tập theo hướng ngang/khổ ngang.
- Và ở trên cùng của tùy chọn kiểm soát Bộ sưu tập theo hướng dọc/khổ dọc.
Mọi thay đổi bạn thực hiện trong mẫu đều được phản ánh trên toàn tùy chọn kiểm soát Bộ sưu tập.
Luôn có các mẫu định sẵn để hiển thị hình ảnh và văn bản trong bộ sưu tập, ngoài ra còn có bộ sưu tập cho các mục có chiều cao biến đổi.
Giới hạn
Kiểm soát thư viện có những hạn chế sau:
- Nếu người dùng cuộn tùy chọn kiểm soát 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 xem có thể bị đẩy xuống và ra khỏi tầm nhìn khi quá trình tải dữ liệu kết thúc. Để tránh vấn đề này, hãy sử dụng tùy chọn kiểm soát Bộ sưu tập tiêu chuẩn thay cho biến Chiều cao linh hoạt.
- Các điều khiển sau không được hỗ trợ trong thư viện:
- Bạn chỉ có thể thêm một thư viện bên trong một thư viện khác.
- Kích thướ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 Thư viện sai lệch so với dự kiến X hoặc Y dự kiến giá trị khi bạn không tính đến kích thước mẫu.
- Nếu bạn tự động tạo một ứng dụng từ dữ liệu, hãy lưu ứng dụng và sau đó mở lại, bộ sưu tập trình duyệt có thể không hiển thị dữ liệu ngay lập tức. Để 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, sau đó xóa nội dung bạn đã nhập. Thư viện sau đó sẽ hiển thị dữ liệu như mong đợi.
Thuộc tính khóa
Default – 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.
Items – Nguồn dữ liệu xuất hiện trong tùy chọn kiểm soát, chẳng hạn như bộ sưu tập, 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 trình đọc màn hình. Sẽ mô tả danh sách các mục là gì.
AllItems – Các mục được tải trong thư viện. Con số này có thể ít hơn số lượng Mục thực tế của nguồn dữ liệu. Nhiều mục hơn có thể được tải khi thư viện được cuộn. AllItems cũng chứa các điều khiển được sử dụng trong từng mục trong thư viện.
AllItemsCount - Đếm số mục được tải trong thư viện. Con số này có thể ít hơn số lượng Mục thực tế của nguồn dữ liệu. Nhiều mục hơn có thể được tải khi thư viện được cuộn.
BorderColor – Màu viền của tùy chọn kiểm soát.
BorderStyle – Liệu viền của tùy chọn kiểm soát là Nét liền, Nét đứt, Chấm chấm hay Không có.
BorderThickness – Độ dày viền của tùy chọn kiểm soát.
DelayItemLoading - 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 – Liệu tùy chọn kiểm soát này sẽ cho phép người dùng nhập (Chỉnh sửa), chỉ hiển thị dữ liệu (Xem) hay tắt (Tắt).
Fill – Màu nền của tùy chọn kiểm soát.
Height – Khoảng cách giữa cạnh trên cùng và cạnh dưới cùng của tùy chọn kiểm soát.
ItemAccessibleLabel – Nhãn của từng mục bộ sưu tập cho trình đọc màn hình. Sẽ mô tả từng mục là gì.
LoadingSpinner (Không có, Kiểm soát hoặc Dữ liệu) - Khi Không có, nút xoay sẽ không hiển thị. Khi Kiểm soát | Dữ liệu, nút xoay sẽ hiển thị khi kết xuất thành công dẫn đến các hàng trống hiển thị.
LoadingSpinnerColor - Màu tô của nút xoay tải. Giá trị mặc định là BorderColor.
NavigationStep – Bộ sưu tập cuộn được bao xa nếu thuộc tính ShowNavigation được đặt thành đúng và người dùng chọn mũi tên điều hướng ở một trong hai đầu của bộ sưu tập đó.
Selectable – Liệu các mục bộ sưu tập có thể chọn được hay không. Khi được đặt thành đúng, trình đọc màn hình sẽ xác định bộ sưu tập là danh sách có thể chọn. Bạn chọn mục bằng cách chọn mục đó. Khi được đặt thành sai, trình đọ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ục sẽ không chọn mục đó.
ShowNavigation – Liệu mũi tên có xuất hiện ở mỗi đầu của bộ sưu tập để 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ũi tên hay không.
ShowScrollbar – Liệu 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/khổ dọc. Hoặc chiều rộng của mẫu cho bộ sưu tập theo hướng ngang/khổ ngang. Kích thước tối thiểu là một.
Transition – Hiệu ứng trực quan (Bật lên, Đẩy hoặc Không có) khi người dùng di chuột qua một mục trong bộ sưu tập.
Visible – Liệu tùy chọn kiểm soát sẽ hiển thị hay bị ẩn.
Width – Khoảng cách giữa cạnh trái và cạnh phải của tùy chọn kiểm soát.
WrapCount – Số lượng mục hiển thị trên mỗi hàng hoặc cột dựa trên bố cục ngang hoặc dọc.
X – Khoảng cách giữa cạnh trái của tùy chọn kiểm soát và cạnh trái của vùng chứa chính hoặc màn hình.
Y – Khoảng cách giữa cạnh trên cùng của tùy chọn kiểm soát và cạnh trên cùng của vùng chứa chính hoặc màn hình.
Hàm liên quan
Reset( Control ) - Đặt lại bộ sưu tập 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 giá trị mặc định nếu có.
Lưu ý
Tùy chọn kiểm soát Đặt lại không đặt lại tất cả các mục phụ trong bộ sưu tập.
Ví dụ
Hiển thị và lọc dữ liệu
- Hiển thị văn bản
- Hiển thị hình ảnh
- Lọc dữ liệu bằng cách chọn tùy chọn danh sách
- Lọc dữ liệu bằng cách điều chỉnh thanh trượt
Nhận 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 cứ đâu trong mục bộ sưu tập có nghĩa là chọn, thì phải có độ tương phản màu thích hợp giữa:
- BorderColor và màu bên ngoài bộ sưu tập (nếu có viền).
- Fill và màu bên ngoài bộ sưu tập (nếu không có viền).
Hỗ trợ bộ đọc màn hình
AccessibleLabel phải có sẵn.
Lưu ý
Trình đọ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. Nhãn 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 tùy chọn kiểm soát, 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ủa Selectable thành đúng nếu bạn muốn người dùng chọn một mục bộ sưu tập. Nếu không, hãy đặt giá trị này thành sai.
Khi một mục bộ sưu tập chứa nhiều tùy chọn kiểm soát, hãy sử dụng ItemAccessibleLabel để cung cấp thông tin tóm tắt về các nội dung của mục bộ sưu tập.
Selectable sẽ được đặt thích hợp, tùy thuộc vào việc người dùng có ý chọn mục bộ sưu tập hay không.
Hỗ trợ bàn phím
Cân nhắc đặt ShowScrollbar thành đúng. 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 bất cứ đâu trong mục bộ sưu tập có nghĩa là chọn, thì cũng phải có cách để người dùng bàn phím chọn mục bộ sưu tập. Ví dụ: thêm Button có thuộc tính OnSelect được đặt thành Select(Parent).
Lưu ý
Các tùy chọn kiểm soát bên ngoài bộ sưu tập không được xem xét theo thứ tự điều hướng bàn phím trong bộ sưu tập. Các tùy chọn kiểm soát TabIndex bên trong bộ sưu tập là thuộc phạm vi. Xem phần thuộc tính hỗ trợ tiếp cận để tìm hiểu thêm.
Xem thêm
Sử dụng trục quay DelayItemLoading và Loading để cải thiện hiệu suất trong Thư viện
Lưu ý
Bạn có thể cho chúng tôi biết bạn thích dùng ngôn ngữ nào cho tài liệu không? Làm một cuộc khảo sát ngắn. (xin lưu ý, khảo sát này bằng tiếng Anh)
Cuộc khảo sát sẽ mất khoảng bảy phút. Không có dữ liệu cá nhân nào được thu thập (điều khoản về quyền riêng tư).
Phản hồi
https://aka.ms/ContentUserFeedback.
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem:Gửi và xem ý kiến phản hồi dành cho