a. nhiềuDropdownField[ nhãn, hướng dẫn, bắt buộc, bị vô hiệu hóa, trình giữ chỗ, nhãn lựa chọn, giá trị lựa chọn, giá trị, xác thực, lưu vào, nhóm xác thực, thư bắt buộc, vị trí nhãn, chú giải công cụ trợ giúp, văn bản khả năng truy cập, hiển thịKhi nào, tìm kiếmHiển thị ]
Hiển thị danh sách các lựa chọn để người dùng chọn nhiều mục và lưu các giá trị dựa trên các lựa chọn đã chọn
Nếu người dùng chỉ nên chọn một lựa chọn, thay vào đó hãy sử dụng các nút radio hoặc thành phần thả xuống
Nếu không có nhiều lựa chọn và người dùng sẽ được hưởng lợi từ việc dễ dàng nhìn thấy tất cả chúng cùng một lúc, hãy cân nhắc sử dụng các hộp kiểm
Thông số
TênTừ khóaLoạiMô tảNhãn mác
label
Chữ
Văn bản để hiển thị dưới dạng nhãn trường
Hướng dẫn
instructions
Chữ
Văn bản bổ sung về lĩnh vực này
Yêu cầu
required
Boolean
Xác định nếu một giá trị được yêu cầu để gửi biểu mẫu. Mặc định. sai
Vô hiệu hóa
disabled
Boolean
Xác định xem trường có hiển thị dưới dạng có khả năng chỉnh sửa nhưng chuyển sang màu xám không. Mặc định. sai
Trình giữ chỗ
placeholder
Chữ
Văn bản để hiển thị trong trường khi nó trống
Nhãn lựa chọn
choiceLabels
Danh sách chuỗi văn bản
Mảng tùy chọn để người dùng lựa chọn
Giá trị lựa chọn
choiceValues
Danh sách biến thể
Mảng giá trị được liên kết với các lựa chọn có sẵn
Giá trị đã chọn
value
Danh sách biến thể
Giá trị của các lựa chọn để hiển thị như đã chọn
xác thực
________số 8
Danh sách chuỗi văn bản
Lỗi xác thực hiển thị bên dưới trường khi giá trị không phải là null
Lưu lựa chọn vào
saveInto
Danh sách Lưu
Một hoặc nhiều biến được cập nhật với các giá trị lựa chọn khi người dùng thay đổi các lựa chọn. Sử dụng một. save[] để lưu một giá trị đã sửa đổi hoặc thay thế vào một biến
Nhóm xác thực
instructions
0
Chữ
Khi có mặt, trường này chỉ được xác thực khi một nút trong cùng một nhóm xác thực được nhấn. Xem công thức này để biết thêm thông tin về cách sử dụng các nhóm xác thực
Tin nhắn bắt buộc
instructions
1
Chữ
Thông báo tùy chỉnh để hiển thị khi giá trị của trường là bắt buộc và không được cung cấp
Vị trí nhãn
instructions
2
Chữ
Xác định nơi nhãn xuất hiện. Giá trị hợp lệ
instructions
3 [mặc định] Hiển thị nhãn phía trên thành phầninstructions
4 Hiển thị nhãn bên trái của thành phầninstructions
5 Ẩn nhãn. Trình đọc màn hình sẽ vẫn đọc được nhãn;instructions
6 Căn nhãn dọc theo thành phần bắt đầu từ mép trang
Chú giải công cụ trợ giúp
instructions
7
Chữ
Hiển thị biểu tượng trợ giúp với văn bản được chỉ định dưới dạng chú giải công cụ. Chú giải công cụ hiển thị tối đa 500 ký tự. Biểu tượng trợ giúp không hiển thị khi vị trí nhãn là instructions
5
Văn bản trợ năng
instructions
9
Chữ
Văn bản bổ sung sẽ được công bố bởi trình đọc màn hình. Chỉ được sử dụng cho khả năng tiếp cận;
Hiển thị
required
0
Boolean
Xác định xem thành phần có được hiển thị trên giao diện hay không. Khi được đặt thành false, thành phần này bị ẩn và không được đánh giá. Mặc định. thật
Hiển thị tìm kiếm
required
1
Chữ
Xác định thời điểm hộp tìm kiếm hiển thị phía trên các tùy chọn. Giá trị hợp lệ. required
2 [mặc định], required
3, required
4. Khi được đặt thành required
2, hộp tìm kiếm sẽ hiển thị nếu có nhiều hơn 11 tùy chọn
cân nhắc sử dụng
Sử dụng các tham số ChoiceLabels và ChoiceValues
- Danh sách Nhãn Lựa chọn và danh sách Giá trị Lựa chọn phải có cùng độ dài
- Giá trị lựa chọn không được chứa giá trị rỗng hoặc giá trị trùng lặp
- Các lựa chọn hiển thị theo thứ tự như được xác định trong tham số Nhãn lựa chọn. Đối số Nhãn lựa chọn không được rỗng
Chọn, lưu và xóa các giá trị
- Nếu một mục duy nhất được chọn, hệ thống sẽ lưu một mảng một mục
- Nếu không có lựa chọn nào được thực hiện hoặc lựa chọn bị xóa, hệ thống sẽ lưu một giá trị null vào trường Lưu lựa chọn vào của thành phần
- Người dùng luôn có thể xóa giá trị bằng biểu tượng
required
6 trên web hoặc liên kếtrequired
7 trên ứng dụng di động
Danh sách thả xuống so với bộ chọn
- Nếu bạn đang cố gắng quyết định nên sử dụng danh sách thả xuống với thành phần tìm kiếm hay bộ chọn, hãy nhớ rằng tìm kiếm thả xuống chạy phía máy khách và chi phí hiệu suất của các tùy chọn tải xảy ra khi tải ban đầu trong khi tìm kiếm bộ chọn chạy phía máy chủ và . Đối với các nhóm tùy chọn nhỏ, chúng tôi khuyên bạn nên sử dụng thành phần thả xuống
ví dụ
Sử dụng trình chỉnh sửa tương tác bên dưới để kiểm tra mã của bạn
Nhiều danh sách thả xuống với lựa chọn đầu tiên được chọn theo mặc định và tìm kiếm tự động
Vì tham số required
1 được đặt thành required
9 và số lượng choiceValues
nhỏ hơn 12 nên sẽ không có hộp tìm kiếm nào được hiển thị
Vì tham số required
1 được đặt thành required
9 và số lượng choiceValues
lớn hơn 11 nên hộp tìm kiếm sẽ được hiển thị
Danh sách thả xuống không có lựa chọn nào được chọn theo mặc định và tìm kiếm trên
Vì tham số required
1 được đặt thành disabled
5, nên mặc dù số lượng choiceValues
nhỏ hơn 12, hộp tìm kiếm sẽ được hiển thị
tính năng tương thích
Bảng bên dưới liệt kê khả năng tương thích của thành phần SAIL này với các tính năng khác nhau trong Appian. Tính năng Tương thíchLưu ýPortalsTương thíchDi động ngoại tuyếnTương thíchBiểu thức trường bản ghi tùy chỉnhKhông tương thíchBáo cáo quy trìnhKhông tương thíchBạn không thể sử dụng chức năng này để định cấu hình báo cáo quy trình
Quá trình Sự kiệnKhông tương thíchBạn không thể sử dụng chức năng này để định cấu hình nút sự kiện quy trình, chẳng hạn như sự kiện bắt đầu hoặc sự kiện hẹn giờ
phiên bản cũ
Có các phiên bản cũ hơn của Thành phần giao diện này. Bạn có thể xác định các phiên bản cũ hơn bằng cách nhìn vào tên để xem có hậu tố phiên bản hay không. Nếu bạn đang sử dụng phiên bản cũ, hãy nhớ tham khảo tài liệu tương ứng từ danh sách bên dưới
Để tìm hiểu thêm về cách Appian xử lý loại phiên bản này, hãy xem trang Phiên bản chức năng và thành phần