Questa pagina è stata tradotta dall'API Cloud Translation.

Class SelectionInput

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.

var 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"));

var 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 selezionabile.
`addMultiSelectItem(text, value, selected, startIconUri, bottomText)`	`SelectionInput`	Aggiunge un nuovo elemento che può essere selezionato, per i menu a selezione multipla.
`setExternalDataSource(action)`	`SelectionInput`	Imposta un'origine dati esterna, ad esempio un database relazionale.
`setFieldName(fieldName)`	`SelectionInput`	Imposta la chiave che identifica questo input di selezione nell'oggetto evento che viene generato quando avviene un'interazione con l'interfaccia utente.
`setMultiSelectMaxSelectedItems(maxSelectedItems)`	`SelectionInput`	Consente di impostare 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 esegua le query per il completamento automatico e mostra gli articoli suggeriti sulla 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 visualizzare prima del campo di immissione.
`setType(type)`	`SelectionInput`	Imposta il tipo di questo input.

Documentazione dettagliata

`addItem(text, value, selected)`

Aggiunge un nuovo elemento selezionabile.

Parametri

Nome	Tipo	Descrizione
`text`	`Object`	Il testo da mostrare per questo elemento. Gli argomenti primitivi non stringa vengono convertiti automaticamente le stringhe.
`value`	`Object`	Il valore di input del modulo inviato tramite il callback. 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 per un menu a discesa), imposta questo campo solo per un elemento.

Invio

SelectionInput: oggetto per il collegamento.

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

Aggiunge un nuovo elemento che può essere selezionato, per i menu a selezione multipla.

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 le stringhe.
`value`	`Object`	Il valore di input del modulo inviato tramite il callback. 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 per un menu a discesa), imposta questo campo solo per un elemento.
`startIconUri`	`Object`	Per i menu a selezione multipla, l'URL dell'icona visualizzata accanto alla voce campo di testo. Supporta file PNG e JPEG.
`bottomText`	`Object`	Per i menu a selezione multipla, una descrizione testuale o un'etichetta visualizzata sotto nel campo di testo dell'elemento.

Invio

SelectionInput: oggetto per il collegamento.

`setExternalDataSource(action)`

Imposta un'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: oggetto per il collegamento.

`setFieldName(fieldName)`

Imposta la chiave che identifica questo input di selezione nell'oggetto evento che viene 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 ingresso.

Invio

SelectionInput: oggetto per il collegamento.

`setMultiSelectMaxSelectedItems(maxSelectedItems)`

Consente di impostare 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: oggetto per il collegamento.

`setMultiSelectMinQueryLength(queryLength)`

Imposta il numero di caratteri di testo inseriti da un utente prima che l'app esegua le query per il completamento automatico e mostra gli articoli suggeriti sulla 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: oggetto per il collegamento.

`setOnChangeAction(action)`

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

Parametri

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

Invio

SelectionInput: oggetto per il collegamento.

`setPlatformDataSource(platformDataSource)`

Imposta un'origine dati da Google Workspace. Utilizzato per completare gli elementi in un menu a selezione multipla.

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: oggetto per il collegamento.

`setTitle(title)`

Imposta il titolo da visualizzare prima del campo di immissione.

Parametri

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

Invio

SelectionInput: oggetto per il collegamento.

`setType(type)`

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

Parametri

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

Invio

SelectionInput: oggetto per il collegamento.