Class SelectionInput

Một trường nhập dữ liệu cho phép chọn trong một nhóm các lựa chọn được xác định trước.

Chỉ hỗ trợ xác thực lượt gửi biểu mẫu cho trình đơn SelectionInputType.DROP_DOWN và SelectionInputType.MULTI_SELECT. Khi Action.setAllWidgetsAreRequired(allWidgetsAreRequired) được đặt thành true hoặc tiện ích này được chỉ định thông qua Action.addRequiredWidget(requiredWidget), hành động gửi sẽ bị chặn trừ phi bạn chọn một giá trị.

Dành cho tiện ích bổ sung của Google Workspace và ứng dụng Google Chat.

const 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'),
        );

const 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
`addDataSourceConfig(dataSourceConfig)`	`SelectionInput`	Đặt cấu hình nguồn dữ liệu cho chế độ kiểm soát lựa chọn.
`addEventAction(eventAction)`	`Widget`	Thêm thao tác sự kiện có thể thực hiện trên tiện ích.
`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 cho trình đơn chọn nhiều.
`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 lựa chọn đầu vào 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.
`setId(id)`	`Widget`	Đặt mã nhận dạng duy nhất được chỉ định dùng để xác định tiện ích cần thay đổi.
`setMultiSelectMaxSelectedItems(maxSelectedItems)`	`SelectionInput`	Đặt số lượng tối đa các mục 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 thị các mục được đề xuất trên thẻ.
`setOnChangeAction(action)`	`SelectionInput`	Đặt một `Action` sẽ được thực hiện bất cứ khi nào lựa chọn đầu vào thay đổi.
`setPlatformDataSource(platformDataSource)`	`SelectionInput`	Đặt một nguồn dữ liệu từ Google Workspace.
`setTitle(title)`	`SelectionInput`	Đặt tiêu đề sẽ xuất hiện trước trường nhập dữ liệu.
`setType(type)`	`SelectionInput`	Đặt loại đầu vào này.
`setVisibility(visibility)`	`Widget`	Đặt chế độ hiển thị của tiện ích.

Tài liệu chi tiết

`addDataSourceConfig(dataSourceConfig)`

Đặt cấu hình nguồn dữ liệu cho chế độ kiểm soát lựa chọn. Trường này giúp bạn kiểm soát nguồn dữ liệu một cách chi tiết hơn. Đây là trường không bắt buộc.

const multiSelect =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.MULTI_SELECT)
        .setFieldName('contacts')
        .setTitle('Selected contacts')
        .setDataSourceConfig(
            CardService.newDataSourceConfig().setPlatformDataSource(
                CardService.newPlatformDataSource().setCommonDataSource(
                    CardService.CommonDataSource.USER,
                )
            )
        );

Tham số

Tên	Loại	Mô tả
`dataSourceConfig`	`DataSourceConfig`	Cấu hình nguồn dữ liệu sẽ được áp dụng cho đầu vào lựa chọn.

Cầu thủ trả bóng

SelectionInput – Đối tượng này, để liên kết.

`addEventAction(eventAction)`

Thêm thao tác sự kiện có thể thực hiện trên tiện ích.

Tham số

Tên	Loại	Mô tả
`eventAction`	`EventAction`	`EventAction` cần thêm.

Cầu thủ trả bóng

Widget – Đối tượng, để liên kết.

`addItem(text, value, selected)`

Thêm một mục mới có thể chọn.

Tham số

Tên	Loại	Mô tả
`text`	`Object`	Văn bản sẽ xuất hiện cho mục này. Các đối số nguyên thuỷ không phải chuỗi sẽ tự động được chuyển đổi thành chuỗi.
`value`	`Object`	Giá trị đầu vào của biểu mẫu được gửi qua lệnh gọi lại. Các đối số nguyên thuỷ không phải chuỗi sẽ tự động được chuyển đổi thành chuỗi.
`selected`	`Boolean`	Mục đó có được chọn theo mặc định hay không. Nếu lựa chọn đầu vào chỉ chấp nhận một giá trị (chẳng hạn như đối với nút radio hoặc một trình đơn thả xuống), chỉ đặt trường này cho một mục.

Cầu thủ trả bóng

SelectionInput – Đối tượng này, để liên kết.

`addMultiSelectItem(text, value, selected, startIconUri, bottomText)`

Thêm một mục mới có thể chọn cho trình đơn chọn nhiều.

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	Mô tả
`text`	`Object`	Văn bản sẽ xuất hiện cho mục này. Các đối số nguyên thuỷ không phải chuỗi sẽ tự động được chuyển đổi thành chuỗi.
`value`	`Object`	Giá trị đầu vào của biểu mẫu được gửi qua lệnh gọi lại. Các đối số nguyên thuỷ không phải chuỗi sẽ tự động được chuyển đổi thành chuỗi.
`selected`	`Boolean`	Mục đó có được chọn theo mặc định hay không. Nếu lựa chọn đầu vào chỉ chấp nhận một giá trị (chẳng hạn như đối với nút radio hoặc một trình đơn thả xuống), chỉ đặt trường này cho một mục.
`startIconUri`	`Object`	Đối với trình đơn chọn nhiều, URL cho biểu tượng xuất hiện bên cạnh trường văn bản của mục. Hỗ trợ tệp PNG và JPEG.
`bottomText`	`Object`	Đối với trình đơn chọn nhiều, nội dung mô tả bằng văn bản hoặc nhã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, để liên kết.

`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	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, để liên kết.

`setFieldName(fieldName)`

Đặt khoá xác định lựa chọn đầu vào 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. Người dùng không nhìn thấy. Bắt buộc, phải là duy nhất.

Tham số

Tên	Loại	Mô tả
`fieldName`	`String`	Tên cần chỉ định cho đầu vào này.

Cầu thủ trả bóng

SelectionInput – Đối tượng này, để liên kết.

`setId(id)`

Đặt mã nhận dạng duy nhất được chỉ định dùng để xác định tiện ích cần thay đổi. Chỉ có Tiện ích bổ sung mới hỗ trợ thao tác thay đổi tiện ích.

Tham số

Tên	Loại	Mô tả
`id`	`String`	Mã nhận dạng của tiện ích, có giới hạn 64 ký tự và ở định dạng `[a-zA-Z0-9-]+`.

Cầu thủ trả bóng

Widget – Đối tượng này, để liên kết.

`setMultiSelectMaxSelectedItems(maxSelectedItems)`

Đặt số lượng tối đa các mục 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	Mô tả
`maxSelectedItems`	`Integer`	Số lượng mặt hàng tối đa.

Cầu thủ trả bóng

SelectionInput – Đối tượng này, để liên kết.

`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 thị các mục đượ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	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, để liên kết.

`setOnChangeAction(action)`

Đặt một Action sẽ được thực hiện bất cứ khi nào lựa chọn đầu vào thay đổi.

Tham số

Tên	Loại	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, để liên kết.

`setPlatformDataSource(platformDataSource)`

Đặt một nguồn dữ liệu từ Google Workspace. Dùng để điền các mục vào một trình đơn chọn nhiều.

const multiSelect =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.MULTI_SELECT)
        .setFieldName('contacts')
        .setTitle('Selected contacts')
        .setPlatformDataSource(
            CardService.newPlatformDataSource().setCommonDataSource(
                CardService.CommonDataSource.USER,
                ),
        );

Chỉ dành cho các ứng dụng Google Chat. Không dùng được cho các tiện ích bổ sung của Google Workspace.

Tham số

Tên	Loại	Mô tả
`platformDataSource`	`PlatformDataSource`	Nguồn dữ liệu.

Cầu thủ trả bóng

SelectionInput – Đối tượng này, để liên kết.

`setTitle(title)`

Đặt tiêu đề sẽ xuất hiện trước trường nhập dữ liệu.

Tham số

Tên	Loại	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, để liên kết.

`setType(type)`

Đặt loại đầu vào này. Giá trị mặc định là CHECKBOX.

Tham số

Tên	Loại	Mô tả
`type`	`SelectionInputType`	Loại lựa chọn.

Cầu thủ trả bóng

SelectionInput – Đối tượng này, để liên kết.

`setVisibility(visibility)`

Đặt chế độ hiển thị của tiện ích. Giá trị mặc định là "VISIBLE".

Tham số

Tên	Loại	Mô tả
`visibility`	`Visibility`	`Visibility` của tiện ích.

Cầu thủ trả bóng

Widget – Đối tượng, để liên kết.

Class SelectionInput Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Phương thức

Tài liệu chi tiết

addDataSourceConfig(dataSourceConfig)

Tham số

Cầu thủ trả bóng

addEventAction(eventAction)

Tham số

Cầu thủ trả bóng

addItem(text, value, selected)

Tham số

Cầu thủ trả bóng

addMultiSelectItem(text, value, selected, startIconUri, bottomText)

Tham số

Cầu thủ trả bóng

setExternalDataSource(action)

Tham số

Cầu thủ trả bóng

setFieldName(fieldName)

Tham số

Cầu thủ trả bóng

setId(id)

Tham số

Cầu thủ trả bóng

setMultiSelectMaxSelectedItems(maxSelectedItems)

Tham số

Cầu thủ trả bóng

setMultiSelectMinQueryLength(queryLength)

Tham số

Cầu thủ trả bóng

setOnChangeAction(action)

Tham số

Cầu thủ trả bóng

setPlatformDataSource(platformDataSource)

Tham số

Cầu thủ trả bóng

setTitle(title)

Tham số

Cầu thủ trả bóng

setType(type)

Tham số

Cầu thủ trả bóng

setVisibility(visibility)

Tham số

Cầu thủ trả bóng

Class SelectionInput

`addDataSourceConfig(dataSourceConfig)`

`addEventAction(eventAction)`

`addItem(text, value, selected)`

`addMultiSelectItem(text, value, selected, startIconUri, bottomText)`

`setExternalDataSource(action)`

`setFieldName(fieldName)`

`setId(id)`

`setMultiSelectMaxSelectedItems(maxSelectedItems)`

`setMultiSelectMinQueryLength(queryLength)`

`setOnChangeAction(action)`

`setPlatformDataSource(platformDataSource)`

`setTitle(title)`

`setType(type)`

`setVisibility(visibility)`