Class Columns

Columnas

El widget Columns muestra hasta 2 columnas en una tarjeta o un diálogo. Puedes agregar widgets a cada Column. Los widgets aparecen en el orden en que se especifican. Para ver un ejemplo en las apps de Google Chat, consulta Columnas.

La altura de cada columna se determina según la columna más alta. Por ejemplo, si la primera columna es más alta que la segunda, ambas columnas tienen la altura de la primera. Debido a que cada columna puede contener una cantidad diferente de widgets, no puedes definir filas ni alinear widgets entre las columnas.

Las columnas se muestran una al lado de la otra. Puedes personalizar el ancho de cada columna con el campo HorizontalSizeStyle. Si el ancho de la pantalla del usuario es demasiado estrecho, la segunda columna se une debajo de la primera:

  • En la Web, la segunda columna se une si el ancho de la pantalla es menor o igual a 480 píxeles.
  • En dispositivos iOS, la segunda columna se une si el ancho de la pantalla es inferior o igual a 300 pt.
  • En dispositivos Android, la segunda columna se ajusta si el ancho de la pantalla es menor o igual que 320 dp.

Disponible para las apps de Google Chat y los complementos de Google Workspace. Entre las IU de complementos que admiten columnas, se incluyen las siguientes:

  • El diálogo que se muestra cuando los usuarios abren el complemento desde un borrador de correo electrónico.
  • Es el diálogo que se muestra cuando los usuarios abren el complemento desde el menú Agregar archivo adjunto en un evento del Calendario de Google.
    // Build a column that is aligned in the center and fills the space:
    const column =
        CardService.newColumn()
            .setHorizontalSizeStyle(
                CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE)
            .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER)
            .setVerticalAlignment(CardService.VerticalAlignment.CENTER);
    const columns = CardService.newColumns().addColumn(column).setWrapStyle(
        CardService.WrapStyle.WRAP);

Métodos

MétodoTipo de datos que se muestraDescripción breve
addColumn(column)ColumnsAgrega un Column al widget Columnas.
setWrapStyle(wrapStyle)ColumnsEstablece el estilo de unión de las columnas y controla cómo se cambia el tamaño de la columna en función del ancho de la pantalla.

Documentación detallada

addColumn(column)

Agrega un Column al widget Columnas. Las columnas se muestran en el orden en que se agregan. Puedes agregar hasta dos columnas.

const columns = CardService.newColumns().addColumn(CardService.newColumn());

Parámetros

NombreTipoDescripción
columnColumnEs una columna secundaria que se agregará al widget Columnas.

Volver

Columns: Este objeto para el encadenamiento.


setWrapStyle(wrapStyle)

Establece el estilo de unión de las columnas y controla cómo se cambia el tamaño de la columna en función del ancho de la pantalla.

const columns = CardService.newColumns()
                    .addColumn(CardService.newColumn())
                    .setWrapStyle(CardService.WrapStyle.WRAP);

Parámetros

NombreTipoDescripción
wrapStyleWrapStyleEl estilo de ajuste que se establecerá para las columnas.

Volver

Columns: Este objeto, para encadenar.