Class SelectionInput

Dane wejściowe do wyboru

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

MetodaZwracany typKrótki opis
addItem(text, value, selected)SelectionInputDodaje nowy element, który można wybrać.
setFieldName(fieldName)SelectionInputUstawia klucz identyfikujący ten wybór w obiekcie zdarzenia wygenerowanym, gdy wystąpi interakcja z interfejsem.
setOnChangeAction(action)SelectionInputUstawia wartość Action, która ma być wywoływana po każdej zmianie danych wejściowych.
setTitle(title)SelectionInputUstawia tytuł, który będzie wyświetlany przed polem do wprowadzania danych.
setType(type)SelectionInputUstawia typ tych danych wejściowych.

Szczegółowa dokumentacja

addItem(text, value, selected)

Dodaje nowy element, który można wybrać.

Parametry

NazwaTypOpis
textObjectTekst, który będzie wyświetlany dla tego elementu. Argumenty podstawowe inne niż ciągi są automatycznie konwertowane na ciągi znaków.
valueObjectWartość 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.
selectedBooleanOkreś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

NazwaTypOpis
fieldNameStringNazwa, 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

NazwaTypOpis
actionActionDział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

NazwaTypOpis
titleStringTytuł pola wprowadzania.

Zwróć

SelectionInput – ten obiekt do łańcucha.


setType(type)

Ustawia typ tych danych wejściowych. Domyślna wartość to CHECKBOX.

Parametry

NazwaTypOpis
typeSelectionInputTypeTyp wyboru.

Zwróć

SelectionInput – ten obiekt do łańcucha.