Un campo di immissione che consente di scegliere tra un insieme di opzioni predefinite.
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 |
---|---|---|
add | Selection | Aggiunge un nuovo elemento che può essere selezionato. |
add | Selection | Aggiunge un nuovo elemento che può essere selezionato per i menu con più opzioni. |
set | Selection | Imposta l'origine dati esterna, ad esempio un database relazionale. |
set | Selection | Imposta la chiave che identifica questo input di selezione nell'oggetto evento generato quando avviene un'interazione con l'interfaccia utente. |
set | Selection | Imposta il numero massimo di elementi che un utente può selezionare. |
set | Selection | 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. |
set | Selection | Imposta un Action da eseguire ogni volta che l'input di selezione cambia. |
set | Selection | Imposta un'origine dati da Google Workspace. |
set | Selection | Imposta il titolo da mostrare prima del campo di immissione. |
set | Selection | Imposta il tipo di questo input. |
Documentazione dettagliata
add Item(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
Selection
: questo oggetto, per l'accodamento.
add Multi Select Item(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. |
start | Object | Per i menu a selezione multipla, l'URL dell'icona visualizzata accanto al campo di testo dell'elemento. Supporta i file PNG e JPEG. |
bottom | Object | Per i menu a selezione multipla, una descrizione o un'etichetta di testo visualizzata sotto il campo di testo dell'elemento. |
Invio
Selection
: questo oggetto, per l'accodamento.
set External Data Source(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
Selection
: questo oggetto, per l'accodamento.
set Field Name(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 |
---|---|---|
field | String | Il nome da assegnare a questo input. |
Invio
Selection
: questo oggetto, per l'accodamento.
set Multi Select Max Selected Items(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 |
---|---|---|
max | Integer | Il numero massimo di elementi. |
Invio
Selection
: questo oggetto, per l'accodamento.
set Multi Select Min Query Length(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 |
---|---|---|
query | Integer | Il numero di caratteri di testo. |
Invio
Selection
: questo oggetto, per l'accodamento.
set On Change Action(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
Selection
: questo oggetto, per l'accodamento.
set Platform Data Source(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, ), );
Parametri
Nome | Tipo | Descrizione |
---|---|---|
platform | Platform | L'origine dati. |
Invio
Selection
: questo oggetto, per l'accodamento.
set Title(title)
Imposta il titolo da mostrare prima del campo di immissione.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
title | String | Il titolo del campo di immissione. |
Invio
Selection
: questo oggetto, per l'accodamento.
set Type(type)
Imposta il tipo di questo input. Il valore predefinito è CHECKBOX
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
type | Selection | Il tipo di selezione. |
Invio
Selection
: questo oggetto, per l'accodamento.