Class SelectionInput

SelectionInput

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");

Bản dùng thử cho nhà phát triển: Được cung cấp trong Chương trình dùng thử cho nhà phát triển Google Workspace, chương trình cấp quyền truy cập sớm vào một số tính năng.

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"));

Bản dùng thử cho nhà phát triển: Được cung cấp trong Chương trình dùng thử cho nhà phát triển Google Workspace, chương trình cấp quyền truy cập sớm vào một số tính năng.

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");

Bản dùng thử cho nhà phát triển: Được cung cấp trong Chương trình dùng thử cho nhà phát triển Google Workspace, chương trình cấp quyền truy cập sớm vào một số tính năng.

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");

Bản dùng thử cho nhà phát triển: Được cung cấp trong Chương trình dùng thử cho nhà phát triển Google Workspace, chương trình cấp quyền truy cập sớm vào một số tính năng.

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.

Bản dùng thử cho nhà phát triển: Được cung cấp trong Chương trình dùng thử Google Workspace dành cho nhà phát triển, chương trình cấp quyền truy cập sớm vào một số tính năng.

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.