Esta página foi traduzida pela API Cloud Translation.

Class SelectionInput

Um campo de entrada que permite escolher entre um conjunto de opções predefinidas.

Disponível para os apps do Google Workspace Add-ons e do 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);

Métodos

Método	Tipo de retorno	Breve descrição
`addItem(text, value, selected)`	`SelectionInput`	Adiciona um novo item que pode ser selecionado.
`addMultiSelectItem(text, value, selected, startIconUri, bottomText)`	`SelectionInput`	Adiciona um novo item que pode ser selecionado para menus de várias seleções.
`setExternalDataSource(action)`	`SelectionInput`	Define a fonte de dados externa, como um banco de dados relacional.
`setFieldName(fieldName)`	`SelectionInput`	Define a chave que identifica essa entrada de seleção no objeto de evento gerado quando há uma interação com a interface.
`setMultiSelectMaxSelectedItems(maxSelectedItems)`	`SelectionInput`	Define o número máximo de itens que um usuário pode selecionar.
`setMultiSelectMinQueryLength(queryLength)`	`SelectionInput`	Define o número de caracteres de texto que um usuário digita antes que o app consulte o preenchimento automático e mostre os itens sugeridos no card.
`setOnChangeAction(action)`	`SelectionInput`	Define uma `Action` para ser executada sempre que a entrada de seleção mudar.
`setPlatformDataSource(platformDataSource)`	`SelectionInput`	Define uma fonte de dados do Google Workspace.
`setTitle(title)`	`SelectionInput`	Define o título que será mostrado antes do campo de entrada.
`setType(type)`	`SelectionInput`	Define o tipo dessa entrada.

Documentação detalhada

`addItem(text, value, selected)`

Adiciona um novo item que pode ser selecionado.

Parâmetros

Nome	Tipo	Descrição
`text`	`Object`	O texto a ser mostrado para esse item. Os argumentos primitivos que não são de string são convertidos em strings automaticamente.
`value`	`Object`	O valor de entrada do formulário enviado pelo callback. Os argumentos primitivos que não são de string são convertidos em strings automaticamente.
`selected`	`Boolean`	Se o item está selecionado por padrão. Se a entrada de seleção aceitar apenas um valor (como para botões de opção ou um menu suspenso), defina esse campo apenas para um item.

Retornar

SelectionInput: este objeto, para encadeamento.

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

Adiciona um novo item que pode ser selecionado para menus de várias seleções.

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

Parâmetros

Nome	Tipo	Descrição
`text`	`Object`	O texto a ser mostrado para esse item. Os argumentos primitivos que não são de string são convertidos em strings automaticamente.
`value`	`Object`	O valor de entrada do formulário enviado pelo callback. Os argumentos primitivos que não são de string são convertidos em strings automaticamente.
`selected`	`Boolean`	Se o item está selecionado por padrão. Se a entrada de seleção aceitar apenas um valor (como para botões de opção ou um menu suspenso), defina esse campo apenas para um item.
`startIconUri`	`Object`	Para menus de múltipla seleção, o URL do ícone exibido ao lado do campo de texto do item. Suporte a arquivos PNG e JPEG.
`bottomText`	`Object`	Para menus de múltipla seleção, uma descrição ou rótulo de texto exibido abaixo do campo de texto do item.

Retornar

SelectionInput: este objeto, para encadeamento.

`setExternalDataSource(action)`

Define a fonte de dados externa, como um banco de dados relacional.

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

Parâmetros

Nome	Tipo	Descrição
`action`	`Action`	A fonte de dados externa.

Retornar

SelectionInput: este objeto, para encadeamento.

`setFieldName(fieldName)`

Define a chave que identifica essa entrada de seleção no objeto de evento gerado quando há uma interação com a interface. Não aparece para o usuário. Obrigatório, precisa ser único.

Parâmetros

Nome	Tipo	Descrição
`fieldName`	`String`	O nome a ser atribuído a essa entrada.

Retornar

SelectionInput: este objeto, para encadeamento.

`setMultiSelectMaxSelectedItems(maxSelectedItems)`

Define o número máximo de itens que um usuário pode selecionar.

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

Parâmetros

Nome	Tipo	Descrição
`maxSelectedItems`	`Integer`	O número máximo de itens.

Retornar

SelectionInput: este objeto, para encadeamento.

`setMultiSelectMinQueryLength(queryLength)`

Define o número de caracteres de texto que um usuário digita antes que o app consulte o preenchimento automático e mostre os itens sugeridos no card.

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

Parâmetros

Nome	Tipo	Descrição
`queryLength`	`Integer`	O número de caracteres de texto.

Retornar

SelectionInput: este objeto, para encadeamento.

`setOnChangeAction(action)`

Define uma Action para ser executada sempre que a entrada de seleção mudar.

Parâmetros

Nome	Tipo	Descrição
`action`	`Action`	A ação a ser tomada.

Retornar

SelectionInput: este objeto, para encadeamento.

`setPlatformDataSource(platformDataSource)`

Define uma fonte de dados do Google Workspace. Usado para preencher itens em um menu de múltipla seleção.

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

Disponível apenas para apps do Google Chat. Não disponível para complementos do Google Workspace.

Parâmetros

Nome	Tipo	Descrição
`platformDataSource`	`PlatformDataSource`	A fonte de dados.

Retornar

SelectionInput: este objeto, para encadeamento.

`setTitle(title)`

Define o título que será mostrado antes do campo de entrada.

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	O título do campo de entrada.

Retornar

SelectionInput: este objeto, para encadeamento.

`setType(type)`

Define o tipo dessa entrada. O valor padrão é CHECKBOX.

Parâmetros

Nome	Tipo	Descrição
`type`	`SelectionInputType`	O tipo de seleção.

Retornar

SelectionInput: este objeto, para encadeamento.