Pole do wprowadzania danych umożliwiające wybór zestawu gotowych opcji.
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);
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addItem(text, value, selected) | SelectionInput | Dodaje nowy element, który można wybrać. |
setFieldName(fieldName) | SelectionInput | Ustawia klucz identyfikujący ten wybór w obiekcie zdarzenia wygenerowanym, gdy wystąpi interakcja z interfejsem. |
setOnChangeAction(action) | SelectionInput | Ustawia wartość Action , która ma być wywoływana po każdej zmianie danych wejściowych. |
setTitle(title) | SelectionInput | Ustawia tytuł, który będzie wyświetlany przed polem do wprowadzania danych. |
setType(type) | SelectionInput | Ustawia typ tych danych wejściowych. |
Szczegółowa dokumentacja
addItem(text, value, selected)
Dodaje nowy element, który można wybrać.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | Object | Tekst, który będzie wyświetlany dla tego elementu. Argumenty podstawowe inne niż ciągi są automatycznie konwertowane na ciągi znaków. |
value | Object | Wartość wejściowa formularza, która jest wysyłana przez wywołanie zwrotne. Argumenty podstawowe inne niż ciągi są automatycznie konwertowane na ciągi znaków. |
selected | Boolean | Określa, czy element powinien zaczynać się od zaznaczenia czy nie. |
Zwróć
SelectionInput
– ten obiekt do łańcucha.
setFieldName(fieldName)
Ustawia klucz identyfikujący ten wybór w obiekcie zdarzenia wygenerowanym, gdy wystąpi interakcja z interfejsem. Niewidoczne dla użytkownika. Wymagane, musi być unikalne.
Parametry
Nazwa | Typ | Opis |
---|---|---|
fieldName | String | Nazwa, którą chcesz przypisać do tego wejścia. |
Zwróć
SelectionInput
– ten obiekt do łańcucha.
setOnChangeAction(action)
Ustawia wartość Action
, która ma być wywoływana po każdej zmianie danych wejściowych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
action | Action | Działanie, które należy podjąć. |
Zwróć
SelectionInput
– ten obiekt do łańcucha.
setTitle(title)
Ustawia tytuł, który będzie wyświetlany przed polem do wprowadzania danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Tytuł pola wprowadzania. |
Zwróć
SelectionInput
– ten obiekt do łańcucha.
setType(type)
Ustawia typ tych danych wejściowych. Domyślna wartość to CHECKBOX
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
type | SelectionInputType | Typ wyboru. |
Zwróć
SelectionInput
– ten obiekt do łańcucha.