Questa pagina è stata tradotta dall'API Cloud Translation.

Class SelectionInput

Un campo di immissione che consente di scegliere tra un insieme di opzioni predefinite.

Supporta la convalida dell'invio dei moduli solo per i menu SelectionInputType.DROP_DOWN e SelectionInputType.MULTI_SELECT. Quando Action.setAllWidgetsAreRequired(allWidgetsAreRequired) è impostato su true o questo widget è specificato tramite Action.addRequiredWidget(requiredWidget), l'azione di invio viene bloccata, a meno che non venga selezionato un valore.

Disponibile per i componenti aggiuntivi di Google Workspace e le app 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);

Metodi

Metodo	Tipo restituito	Breve descrizione
`addItem(text, value, selected)`	`SelectionInput`	Aggiunge un nuovo elemento che può essere selezionato.
`addMultiSelectItem(text, value, selected, startIconUri, bottomText)`	`SelectionInput`	Aggiunge un nuovo elemento che può essere selezionato per i menu con più opzioni.
`setExternalDataSource(action)`	`SelectionInput`	Imposta l'origine dati esterna, ad esempio un database relazionale.
`setFieldName(fieldName)`	`SelectionInput`	Imposta la chiave che identifica questo input di selezione nell'oggetto evento generato quando avviene un'interazione con l'interfaccia utente.
`setMultiSelectMaxSelectedItems(maxSelectedItems)`	`SelectionInput`	Imposta il numero massimo di elementi che un utente può selezionare.
`setMultiSelectMinQueryLength(queryLength)`	`SelectionInput`	Imposta il numero di caratteri di testo inseriti da un utente prima che l'app effettui query sul completamento automatico e visualizza gli elementi suggeriti nella scheda.
`setOnChangeAction(action)`	`SelectionInput`	Imposta un `Action` da eseguire ogni volta che l'input di selezione cambia.
`setPlatformDataSource(platformDataSource)`	`SelectionInput`	Imposta un'origine dati da Google Workspace.
`setTitle(title)`	`SelectionInput`	Imposta il titolo da mostrare prima del campo di immissione.
`setType(type)`	`SelectionInput`	Imposta il tipo di questo input.

Documentazione dettagliata

`addItem(text, value, selected)`

Aggiunge un nuovo elemento che può essere selezionato.

Parametri

Nome	Tipo	Descrizione
`text`	`Object`	Il testo da mostrare per questo elemento. Gli argomenti primitivi non stringa vengono convertiti automaticamente in stringhe.
`value`	`Object`	Il valore dell'input del modulo inviato tramite il callback. Gli argomenti primitivi non stringa vengono convertiti automaticamente in stringhe.
`selected`	`Boolean`	Indica se l'elemento è selezionato per impostazione predefinita. Se l'input di selezione accetta un solo valore (ad esempio per i pulsanti di opzione o un menu a discesa), imposta questo campo solo per un elemento.

Invio

SelectionInput: questo oggetto, per l'accodamento.

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

Aggiunge un nuovo elemento che può essere selezionato per i menu con più opzioni.

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

Parametri

Nome	Tipo	Descrizione
`text`	`Object`	Il testo da mostrare per questo elemento. Gli argomenti primitivi non stringa vengono convertiti automaticamente in stringhe.
`value`	`Object`	Il valore dell'input del modulo inviato tramite il callback. Gli argomenti primitivi non stringa vengono convertiti automaticamente in stringhe.
`selected`	`Boolean`	Indica se l'elemento è selezionato per impostazione predefinita. Se l'input di selezione accetta un solo valore (ad esempio per i pulsanti di opzione o un menu a discesa), imposta questo campo solo per un elemento.
`startIconUri`	`Object`	Per i menu a più opzioni, l'URL dell'icona visualizzata accanto al campo di testo dell'elemento. Supporta i file PNG e JPEG.
`bottomText`	`Object`	Per i menu a selezione multipla, una descrizione o un'etichetta di testo visualizzata sotto il campo di testo dell'elemento.

Invio

SelectionInput: questo oggetto, per l'accodamento.

`setExternalDataSource(action)`

Imposta l'origine dati esterna, ad esempio un database relazionale.

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

Parametri

Nome	Tipo	Descrizione
`action`	`Action`	L'origine dati esterna.

Invio

SelectionInput: questo oggetto, per l'accodamento.

`setFieldName(fieldName)`

Imposta la chiave che identifica questo input di selezione nell'oggetto evento generato quando avviene un'interazione con l'interfaccia utente. Non visibile all'utente. Obbligatorio, deve essere univoco.

Parametri

Nome	Tipo	Descrizione
`fieldName`	`String`	Il nome da assegnare a questo input.

Invio

SelectionInput: questo oggetto, per l'accodamento.

`setMultiSelectMaxSelectedItems(maxSelectedItems)`

Imposta il numero massimo di elementi che un utente può selezionare.

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

Parametri

Nome	Tipo	Descrizione
`maxSelectedItems`	`Integer`	Il numero massimo di elementi.

Invio

SelectionInput: questo oggetto, per l'accodamento.

`setMultiSelectMinQueryLength(queryLength)`

Imposta il numero di caratteri di testo inseriti da un utente prima che l'app effettui query sul completamento automatico e visualizza gli elementi suggeriti nella scheda.

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

Parametri

Nome	Tipo	Descrizione
`queryLength`	`Integer`	Il numero di caratteri di testo.

Invio

SelectionInput: questo oggetto, per l'accodamento.

`setOnChangeAction(action)`

Imposta un Action da eseguire ogni volta che l'input di selezione cambia.

Parametri

Nome	Tipo	Descrizione
`action`	`Action`	L'azione da eseguire.

Invio

SelectionInput: questo oggetto, per l'accodamento.

`setPlatformDataSource(platformDataSource)`

Imposta un'origine dati da Google Workspace. Utilizzato per compilare gli elementi in un menu a più scelte.

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

Disponibile solo per le app Google Chat. Non disponibile per i componenti aggiuntivi di Google Workspace.

Parametri

Nome	Tipo	Descrizione
`platformDataSource`	`PlatformDataSource`	L'origine dati.

Invio

SelectionInput: questo oggetto, per l'accodamento.

`setTitle(title)`

Imposta il titolo da mostrare prima del campo di immissione.

Parametri

Nome	Tipo	Descrizione
`title`	`String`	Il titolo del campo di immissione.

Invio

SelectionInput: questo oggetto, per l'accodamento.

`setType(type)`

Imposta il tipo di questo input. Il valore predefinito è CHECKBOX.

Parametri

Nome	Tipo	Descrizione
`type`	`SelectionInputType`	Il tipo di selezione.

Invio

SelectionInput: questo oggetto, per l'accodamento.