Trang này được dịch bởi Cloud Translation API.

Class SelectionInput

Một trường nhập cho phép chọn trong số một tập hợp các tuỳ chọn được xác định trước.

Có sẵn cho các ứng dụng Tiện ích bổ sung của Google Workspace và 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	Loại dữ liệu trả về	Mô tả ngắn
`addItem(text, value, selected)`	`SelectionInput`	Thêm một mục mới có thể được chọn.
`addMultiSelectItem(text, value, selected, startIconUri, bottomText)`	`SelectionInput`	Thêm một mục mới có thể được chọn, cho các trình đơn có thể chọ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 lựa chọn này trong đối tượng sự kiện được tạo khi có 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 thị các mục được đề xuất trên thẻ.
`setOnChangeAction(action)`	`SelectionInput`	Đặt `Action` để thực hiện bất cứ khi nào dữ liệu đầu vào lựa chọn thay đổi.
`setPlatformDataSource(platformDataSource)`	`SelectionInput`	Đặt nguồn dữ liệu từ Google Workspace.
`setTitle(title)`	`SelectionInput`	Đặt tiêu đề sẽ hiển thị trước trường nhập.
`setType(type)`	`SelectionInput`	Đặt loại dữ liệu đầ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ể được chọn.

Tham số

Tên	Loại	Mô tả
`text`	`Object`	Văn bản sẽ hiển thị cho mục này. Các đối số gốc không phải chuỗi sẽ tự động được chuyển đổi thành chuỗi.
`value`	`Object`	Giá trị nhập của biểu mẫu được gửi qua lệnh gọi lại. Các đối số 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 dữ liệu đầu vào lựa chọn chỉ chấp nhận một giá trị (chẳng hạn như đối với nút chọn hoặc trình đơn thả xuống), hãy chỉ đặ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ể được chọn, cho các trình đơn có thể chọ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	Mô tả
`text`	`Object`	Văn bản sẽ hiển thị cho mục này. Các đối số gốc không phải chuỗi sẽ tự động được chuyển đổi thành chuỗi.
`value`	`Object`	Giá trị nhập của biểu mẫu được gửi qua lệnh gọi lại. Các đối số 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 dữ liệu đầu vào lựa chọn chỉ chấp nhận một giá trị (chẳng hạn như đối với nút chọn hoặc trình đơn thả xuống), hãy chỉ đặt trường này cho một mục.
`startIconUri`	`Object`	Đối với trình đơn nhiều lựa chọn, URL của biểu tượng sẽ hiển thị 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 nhiều lựa chọn, một nhãn hoặc nội dung mô tả bằng văn bản sẽ 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	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 lựa chọn này trong đối tượng sự kiện được tạo khi có 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 gán cho dữ liệu đầu vào 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	Mô tả
`maxSelectedItems`	`Integer`	Số 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 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ố 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ực hiện bất cứ khi nào dữ liệu đầu vào lựa chọn 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, để tạo chuỗi.

`setPlatformDataSource(platformDataSource)`

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

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 ứ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, để tạo chuỗi.

`setTitle(title)`

Đặt tiêu đề sẽ hiển thị trước trường nhập.

Tham số

Tên	Loại	Mô tả
`title`	`String`	Tiêu đề trường nhập.

Cầu thủ trả bóng

SelectionInput – Đối tượng này, để tạo chuỗi.

`setType(type)`

Đặt loại dữ liệu đầ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, để tạo chuỗi.