Chia sẻ qua

Điều khiển hộp tổ hợp trong Power Apps

Tùy chọn kiểm soát cho phép người dùng đưa ra lựa chọn trong số các lựa chọn đã cho. Hỗ trợ tìm kiếm và nhiều lựa chọn.

Sự miêu tả

Điều khiển hộp tổ hợp cho phép bạn tìm kiếm các mục bạn sẽ chọn. Tìm kiếm được thực hiện phía máy chủ trên thuộc tính SearchField vì vậy hiệu suất không bị ảnh hưởng bởi các nguồn dữ liệu lớn.

Chế độ chọn một hoặc nhiều lựa chọn được đặt cấu hình thông qua thuộc tính SelectMultiple.

Khi tìm kiếm các mục cần chọn, cho mỗi mục bạn có thể chọn hiển thị một giá trị dữ liệu duy nhất, hai giá trị hoặc một ảnh và hai giá trị (Người) bằng cách sửa đổi cài đặt Bố trí trong ngăn Dữ liệu.

Khi bạn xem điều khiển trên màn hình nhỏ, cửa sổ bật lên danh sách mục sẽ trở thành điều khiển toàn màn hình để có thể sử dụng tốt hơn.

Lưu ý

Nếu bạn muốn tìm kiếm các mục có số, hãy chuyển đổi số thành văn bản bằng hàm Text( ). Ví dụ: Text(12345).

Giới hạn

Điều khiển hộp tổ hợp có những giới hạn sau:

  • Khi bạn sử dụng điều khiển Hộp tổ hợp bên trong bộ sưu tập, các lựa chọn của bộ sưu tập không được duy trì khi người dùng cuộn bộ sưu tập. Đây không phải là sự cố nếu bạn sử dụng điều khiển Hộp tổ hợp bên trong bộ sưu tập không cuộn. Giải pháp thay thế hiện không sẵn dùng.

Bộ chọn người

Để sử dụng Hộp tổ hợp làm bộ chọn người, hãy chọn mẫu Người từ thiết đặt Bố trí trong ngăn Dữ liệu và cấu hình các thuộc tính dữ liệu liên quan sẽ được hiển thị cho người bên dưới.

Thuộc tính khóa

Items – Nguồn dữ liệu có thể được lựa chọn từ đó.

DefaultSelectedItems – (các) mục được chọn ban đầu trước khi người dùng tương tác với điều khiển.

Lưu ý

Thuộc tính mặc định không được chấp nhận, thay vào đó hãy sử dụng DefaultSelectedItems .

SelectedItems – Danh sách các mục được chọn do tương tác của người dùng.

Đã chọn – Mục được chọn cuối cùng do tương tác của người dùng.

SelectMultiple – Người dùng có thể chọn một mục hay nhiều mục.

IsSearchable – Liệu người dùng có thể tìm kiếm các mục trước khi chọn hay không.

Lưu ý

Chỉ có thể bật IsSearchable trên nguồn dữ liệu có chứa ít nhất một trường văn bản. Biểu thức Khoản mục phải được xóa bỏ để truy vấn được ủy nhiệm tìm kiếm. Nghĩa là, câu lệnh If trong biểu thức Items không được hỗ trợ.

SearchFields - Trường dữ liệu của nguồn dữ liệu được tìm kiếm khi người dùng nhập văn bản.

Lưu ý

Để tìm kiếm trên nhiều trường, hãy đặt thuộc tính SearchFields theo định dạng này: ["MyFirstColumn", "MySecondColumn"]. Chỉ hỗ trợ trường văn bản.

Thuộc tính bổ sung

AccessibleLabel – Nhãn cho bộ đọc màn hình.

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.

DisplayFields – Danh sách các trường được hiển thị cho mỗi mục do tìm kiếm trả về. Dễ nhất để đặt cấu hình thông qua ngăn Dữ liệu trong tab tùy chọn Thuộc tính.

Lưu ý

Để cập nhật nhiều trường hiển thị trong mẫu đã cho, hãy đặt thuộc tính DisplayFields theo định dạng này: ["MyFirstColumn", "MySecondColumn"].

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).

FocusedBorderColor – Màu sắc của viền điều khiển khi điều khiển được tập trung.

FocusedBorderThickness – Độ dày của viền điều khiển khi điều khiển được tập trung.

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.

InputTextPlaceholder – Văn bản hướng dẫn được hiển thị cho người dùng cuối khi không có mục nào được chọn.

OnChange – Hành động cần thực hiện khi người dùng thay đổi lựa chọn.

OnNavigate – Hành động cần thực hiện khi người dùng chọn một mục.

OnSelect – Hành động cần thực hiện khi người dùng nhấn hoặc chọn một điều khiển.

TabIndex – Thứ tự dẫn hướng bàn phím liên quan đến các điều khiển khác.

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.

X – Khoảng cách giữa cạnh trái của một điều khiển và cạnh trái của vùng chứa cha của nó (màn hình nếu không có vùng chứa cha).

Y – Khoảng cách giữa cạnh trên của một điều khiển và cạnh trên của vùng chứa cha (màn hình nếu không có vùng chứa cha).

Lưu ý

Thuộc tính viền bay ra được kiểm soát bởi thuộc tính Viền.

Ví dụ

Hộp Tổ hợp Cơ bản

Các bước trong ví dụ này áp dụng cho bất kỳ nguồn dữ liệu nào cung cấp bảng, nhưng để làm theo các bước này một cách chính xác, hãy sử dụng một môi trường với cơ sở dữ liệu Microsoft Dataverse có dữ liệu mẫu.

  1. Chọn Chèn hộp>Tổ>hợp Đầu vào và đặt tên cho nó là "Combobox1".

  2. Trên ngăn Thuộc tính ở bên phải màn hình, mở danh sách Chọn nguồn dữ liệu (bên cạnh Mục), rồi thêm hoặc chọn nguồn dữ liệu, chẳng hạn như bảng Tài khoản.

  3. Trên cùng một ngăn, chọn Chỉnh sửa (bên cạnh Trường).

  4. Trong ngăn Dữ liệu, mở danh sách Văn bản chính, rồi chọn cột Tên Chính sẽ hiển thị trong điều khiển Hộp tổ hợp.

  5. Trong khi nhấn giữ phím Alt , chọn mũi tên xuống để mở điều khiển Hộp tổ hợp.

    Điều khiển hiển thị dữ liệu từ Tên Chính mà bạn đã xác định trong nguồn dữ liệu mà bạn đã xác định.

(Tùy chọn) Hiển thị bản ghi đầu tiên theo mặc định

  1. Đặt thuộc tính DefaultSelectedItems cho biểu thức này, thay thế DataSource bằng tên nguồn dữ liệu của bạn:

    First(DataSource)

(Tùy chọn) Hiển thị giá trị Tên Tài khoản đã chọn trong nhãn

  1. Chọn Chèn>nhãn Văn bản, rồi chọn Nhãn.

  2. Đặt thuộc tính Văn bản cho biểu thức này, thay thế Văn bản bằng công thức sau đây:

    If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")

    Lưu ý

    Câu lệnh If sẽ kiểm tra xem các mục đã chọn có thể tồn tại như thế nào và hiển thị chúng trong nhãn được phân cách bằng dấu phẩy hoặc thông báo "KHÔNG MỤC ĐÃ CHỌN" khi trống.

Mô phỏng hành vi thả xuống đơn giản

Bằng cách đặt IsSearchable thành false và SelectMultiple thành false, bạn có thể đạt được chức năng tương tự của danh sách thả xuống.

  1. Chọn Chèn>Đầu vào, rồi chọn Hộp tổ hợp.

  2. Trên ngăn Thuộc tính ở bên phải màn hình, mở danh sách Chọn nguồn dữ liệu (bên cạnh Mục), rồi thêm hoặc chọn nguồn dữ liệu.

  3. Trên cùng một ngăn, chọn Chỉnh sửa (bên cạnh Trường).

  4. Trong ngăn Dữ liệu, mở danh sách Văn bản chính, rồi chọn cột bạn muốn hiển thị trong điều khiển Hộp tổ hợp.

  5. Đặt thuộc tính IsSearchable thành false.

  6. Đặt thuộc tính SelectMultiple thành false.

  7. Trong khi nhấn giữ phím Alt , chọn mũi tên xuống để mở điều khiển Hộp tổ hợp.

    Điều khiển hiển thị dữ liệu từ cột mà bạn đã xác định trong nguồn dữ liệu mà bạn đã xác định.

    Lưu ý

    Văn bản "Tìm mục" đã biến mất và bạn sẽ chỉ có thể chọn một mục duy nhất.

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

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

Phải có độ tương phản màu đầy đủ giữa:

  • ChevronFill và ChevronBackground
  • ChevronHoverFill và ChevronHoverBackground
  • SelectionColor và SelectionFill
  • Vùng chọn Điền và Điền
  • SelectionTagColor và SelectionTagFill

Điều này là ngoài các yêu cầu độ tương phản màu tiêu chuẩn.

Hỗ trợ bộ đọc màn hình

  • AccessibleLabel phải có mặt.

    Lưu ý

    Trên màn hình cảm ứng, người dùng bộ đọc màn hình có thể dẫn hướng tuần tự nội dung của hộp tổ hợp. Hộp tổ hợp hoạt động như một nút hiển thị hoặc ẩn nội dung của nó khi được chọn.

Hỗ trợ bàn phím

  • TabIndex phải bằng không hoặc lớn hơn để người dùng bàn phím có thể dẫn hướng đến đó.

  • Chỉ báo tiêu điểm phải được hiển thị rõ ràng. Sử dụng FocusedBorderColor và FocusedBorderThickness để đạt được điều này.

    Lưu ý

    Phím tab dẫn hướng đến hoặc ra khỏi hộp tổ hợp. Các phím mũi tên dẫn hướng nội dung của hộp tổ hợp. Phím escape sẽ đóng danh sách thả xuống khi mở.

  • Last updated on