Một trường nhập dữ liệu cho phép lựa chọn giữa một tập hợp các tuỳ chọn được xác định trước.
Được cung cấp cho tiện ích bổ sung của Google Workspace và ứng dụng Google Chat.
var checkboxGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.CHECK_BOX) .setTitle("A group of checkboxes. Multiple selections are allowed.") .setFieldName("checkbox_field") .addItem("checkbox one title", "checkbox_one_value", false) .addItem("checkbox two title", "checkbox_two_value", true) .addItem("checkbox three title", "checkbox_three_value", true) .setOnChangeAction(CardService.newAction() .setFunctionName("handleCheckboxChange")); var radioGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.RADIO_BUTTON) .setTitle("A group of radio buttons. Only a single selection is allowed.") .setFieldName("checkbox_field") .addItem("radio button one title", "radio_one_value", true) .addItem("radio button two title", "radio_two_value", false) .addItem("radio button three title", "radio_three_value", false); const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description") .setMultiSelectMaxSelectedItems(3) .setMultiSelectMinQueryLength(1);
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
addItem(text, value, selected) | SelectionInput | Thêm một mục mới có thể chọn. |
addMultiSelectItem(text, value, selected, startIconUri, bottomText) | SelectionInput | Thêm một mục mới có thể chọn được cho trình đơn nhiều mục. |
setExternalDataSource(action) | SelectionInput | Đặt nguồn dữ liệu bên ngoài, chẳng hạn như cơ sở dữ liệu quan hệ. |
setFieldName(fieldName) | SelectionInput | Đặt khoá xác định dữ liệu đầu vào của lựa chọn này trong đối tượng sự kiện được tạo khi có một hoạt động tương tác trên giao diện người dùng. |
setMultiSelectMaxSelectedItems(maxSelectedItems) | SelectionInput | Đặt số lượng mục tối đa mà người dùng có thể chọn. |
setMultiSelectMinQueryLength(queryLength) | SelectionInput | Đặt số lượng ký tự văn bản mà người dùng nhập trước khi ứng dụng truy vấn tính năng tự động hoàn thành và hiện các mục đề xuất trên thẻ. |
setOnChangeAction(action) | SelectionInput | Đặt Action thành được thực hiện bất cứ khi nào giá trị đầu vào của lựa chọn thay đổi. |
setPlatformDataSource(platformDataSource) | SelectionInput | Thiết lập một nguồn dữ liệu từ Google Workspace. |
setTitle(title) | SelectionInput | Đặt tiêu đề xuất hiện trước trường nhập dữ liệu. |
setType(type) | SelectionInput | Đặt loại của giá trị đầu vào này. |
Tài liệu chi tiết
addItem(text, value, selected)
Thêm một mục mới có thể chọn.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | Object | Văn bản sẽ xuất hiện cho mục này. Các đối số nguyên gốc không phải chuỗi được tự động chuyển đổi thành chuỗi. |
value | Object | Giá trị nhập vào biểu mẫu được gửi qua lệnh gọi lại. Các đối số nguyên gốc không phải chuỗi sẽ được tự động chuyển đổi thành chuỗi. |
selected | Boolean | Liệu mục đó có được chọn theo mặc định hay không. Nếu phương thức nhập lựa chọn chỉ chấp nhận một giá trị (chẳng hạn như các nút chọn hoặc trình đơn thả xuống), thì bạn chỉ được đặt trường này cho một mục. |
Cầu thủ trả bóng
SelectionInput
– Đối tượng này để tạo chuỗi.
addMultiSelectItem(text, value, selected, startIconUri, bottomText)
Thêm một mục mới có thể chọn được cho trình đơn nhiều mục.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description");
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | Object | Văn bản sẽ xuất hiện cho mục này. Các đối số nguyên gốc không phải chuỗi được tự động chuyển đổi thành chuỗi. |
value | Object | Giá trị nhập vào biểu mẫu được gửi qua lệnh gọi lại. Các đối số nguyên gốc không phải chuỗi sẽ được tự động chuyển đổi thành chuỗi. |
selected | Boolean | Liệu mục đó có được chọn theo mặc định hay không. Nếu phương thức nhập lựa chọn chỉ chấp nhận một giá trị (chẳng hạn như các nút chọn hoặc trình đơn thả xuống), thì bạn chỉ được đặt trường này cho một mục. |
startIconUri | Object | Đối với trình đơn chọn nhiều mục, URL của biểu tượng xuất hiện bên cạnh trường văn bản của mục. Hỗ trợ các tệp PNG và JPEG. |
bottomText | Object | Đối với trình đơn chọn nhiều mục, nội dung mô tả hoặc nhãn văn bản xuất hiện bên dưới trường văn bản của mục. |
Cầu thủ trả bóng
SelectionInput
– Đối tượng này để tạo chuỗi.
setExternalDataSource(action)
Đặt nguồn dữ liệu bên ngoài, chẳng hạn như cơ sở dữ liệu quan hệ.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("contacts") .setTitle("Selected contacts") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .setMultiSelectMaxSelectedItems(5) .setMultiSelectMinQueryLength(2) .setExternalDataSource(CardService.newAction().setFunctionName("getContacts"));
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
action | Action | Nguồn dữ liệu bên ngoài. |
Cầu thủ trả bóng
SelectionInput
– Đối tượng này để tạo chuỗi.
setFieldName(fieldName)
Đặt khoá xác định dữ liệu đầu vào của lựa chọn này trong đối tượng sự kiện được tạo khi có một hoạt động tương tác trên giao diện người dùng. Không hiển thị với người dùng. Bắt buộc, phải là duy nhất.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fieldName | String | Tên để gán cho dữ liệu nhập này. |
Cầu thủ trả bóng
SelectionInput
– Đối tượng này để tạo chuỗi.
setMultiSelectMaxSelectedItems(maxSelectedItems)
Đặt số lượng mục tối đa mà người dùng có thể chọn.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .setMultiSelectMaxSelectedItems(3) .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description");
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
maxSelectedItems | Integer | Số lượng mục tối đa. |
Cầu thủ trả bóng
SelectionInput
– Đối tượng này để tạo chuỗi.
setMultiSelectMinQueryLength(queryLength)
Đặt số lượng ký tự văn bản mà người dùng nhập trước khi ứng dụng truy vấn tính năng tự động hoàn thành và hiện các mục đề xuất trên thẻ.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .setMultiSelectMinQueryLength(1) .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description");
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
queryLength | Integer | Số lượng ký tự văn bản. |
Cầu thủ trả bóng
SelectionInput
– Đối tượng này để tạo chuỗi.
setOnChangeAction(action)
Đặt Action
thành được thực hiện bất cứ khi nào giá trị đầu vào của lựa chọn thay đổi.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
action | Action | Hành động cần thực hiện. |
Cầu thủ trả bóng
SelectionInput
– Đối tượng này để tạo chuỗi.
setPlatformDataSource(platformDataSource)
Thiết lập một nguồn dữ liệu từ Google Workspace. Dùng để điền các mục trong trình đơn chọn nhiều mục.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("contacts") .setTitle("Selected contacts") .setPlatformDataSource( CardService.newPlatformDataSource() .setCommonDataSource(CardService.CommonDataSource.USER));Chỉ có trong các ứng dụng Google Chat. Không sử dụng được với tiện ích bổ sung của Google Workspace.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
platformDataSource | PlatformDataSource | Nguồn dữ liệu. |
Cầu thủ trả bóng
SelectionInput
– Đối tượng này để tạo chuỗi.
setTitle(title)
Đặt tiêu đề xuất hiện trước trường nhập dữ liệu.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | Tiêu đề của trường nhập dữ liệu. |
Cầu thủ trả bóng
SelectionInput
– Đối tượng này để tạo chuỗi.
setType(type)
Đặt loại của giá trị đầu vào này. Giá trị mặc định là CHECKBOX
.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
type | SelectionInputType | Loại lựa chọn. |
Cầu thủ trả bóng
SelectionInput
– Đối tượng này để tạo chuỗi.