Class Switch

Switch

Elemento de la IU que admite la activación o desactivación. Solo se puede usar dentro de un widget DecoratedText.

var switchDecoratedText  = CardService.newDecoratedText()
  .setTopLabel("Switch decorated text widget label")
  .setText("This is a decorated text widget with a switch on the right")
  .setWrapText(true)
  .setSwitchControl(CardService.newSwitch()
      .setFieldName("form_input_switch_key")
      .setValue("form_input_switch_value")
      .setOnChangeAction(CardService.newAction()
          .setFunctionName("handleSwitchChange")));

Métodos

MétodoTipo de datos que se muestraDescripción breve
setControlType(controlType)SwitchEstablece el tipo de control del interruptor.
setFieldName(fieldName)SwitchEstablece la clave que identifica este interruptor en el objeto de evento que se genera cuando hay una interacción con la IU.
setOnChangeAction(action)SwitchConfigura la acción que se debe realizar cuando se activa el interruptor.
setSelected(selected)SwitchEstablece si el interruptor debe comenzar como seleccionado o no seleccionado.
setValue(value)SwitchEstablece el valor que se envía como la entrada del formulario cuando este interruptor está activado.

Documentación detallada

setControlType(controlType)

Establece el tipo de control del interruptor. La configuración predeterminada es SWITCH.

Parámetros

NombreTipoDescripción
controlTypeSwitchControlTypeEl tipo de control del interruptor

Devolvedor

Switch: Este objeto se usa para encadenar.


setFieldName(fieldName)

Establece la clave que identifica este interruptor en el objeto de evento que se genera cuando hay una interacción con la IU. No visible para el usuario Obligatorio.

A diferencia de otros campos del formulario, no es necesario que este nombre de campo sea único. Los valores de entrada del formulario para interruptores que usan el mismo nombre de campo se muestran como un array. El array consta de los valores de todos los interruptores habilitados con ese nombre de campo.

Parámetros

NombreTipoDescripción
fieldNameStringLa tecla que se usa para identificar este interruptor.

Devolvedor

Switch: Este objeto se usa para encadenar.


setOnChangeAction(action)

Configura la acción que se debe realizar cuando se activa el interruptor.

Parámetros

NombreTipoDescripción
actionActionLa acción que se realiza cuando el interruptor está activado.

Devolvedor

Switch: Este objeto se usa para encadenar.


setSelected(selected)

Establece si el interruptor debe comenzar como seleccionado o no seleccionado.

Parámetros

NombreTipoDescripción
selectedBooleanLa configuración del estado del interruptor inicial

Devolvedor

Switch: Este objeto se usa para encadenar.


setValue(value)

Establece el valor que se envía como la entrada del formulario cuando este interruptor está activado.

Parámetros

NombreTipoDescripción
valueStringEl valor asociado con el nombre cuando la opción está activada. Cuando se envía a la devolución de llamada de formulario, siempre se representa como una cadena.

Devolvedor

Switch: Este objeto se usa para encadenar.