Class Columns

Colonne

Il widget Columns mostra fino a 2 colonne in una scheda o finestra di dialogo. Puoi aggiungere widget a ogni Column; i widget vengono visualizzati nell'ordine in cui sono specificati. Per un esempio nelle app Google Chat, vedi Colonne.

L'altezza di ogni colonna è determinata dalla colonna più alta. Ad esempio, se la prima colonna è più alta della seconda, entrambe le colonne hanno l'altezza della prima. Poiché ogni colonna può contenere un numero diverso di widget, non puoi definire righe o allineare i widget tra le colonne.

Le colonne vengono visualizzate una accanto all'altra. Puoi personalizzare la larghezza di ogni colonna utilizzando il campo HorizontalSizeStyle. Se la larghezza dello schermo dell'utente è troppo ridotta, la seconda colonna va a capo sotto la prima:

  • Sul web, la seconda colonna va a capo se la larghezza dello schermo è inferiore o uguale a 480 pixel.
  • Sui dispositivi iOS, la seconda colonna va a capo se la larghezza dello schermo è inferiore o uguale a 300 pt.
  • Sui dispositivi Android, la seconda colonna va a capo se la larghezza dello schermo è inferiore o uguale a 320 dp.

Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace. Le UI dei componenti aggiuntivi che supportano le colonne includono:

  • La finestra di dialogo visualizzata quando gli utenti aprono il componente aggiuntivo da una bozza di email.
  • La finestra di dialogo visualizzata quando gli utenti aprono il componente aggiuntivo dal menu Aggiungi allegato in un evento di Google Calendar.
    // 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);

Metodi

MetodoTipo restituitoBreve descrizione
addColumn(column)ColumnsAggiunge una Column al widget Columns.
addEventAction(eventAction)WidgetAggiunge l'azione evento che può essere eseguita sul widget.
setId(id)WidgetImposta l'ID univoco assegnato utilizzato per identificare il widget da modificare.
setVisibility(visibility)WidgetImposta la visibilità del widget.
setWrapStyle(wrapStyle)ColumnsImposta lo stile di ritorno a capo delle colonne, controlla il modo in cui la colonna viene ridimensionata in base alla larghezza dello schermo.

Documentazione dettagliata

addColumn(column)

Aggiunge una Column al widget Columns. Le colonne vengono visualizzate nell'ordine in cui vengono aggiunte. Puoi aggiungere fino a due colonne.

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

Parametri

NomeTipoDescrizione
columnColumnUna colonna secondaria da aggiungere al widget Columns.

Indietro

Columns : questo oggetto, per il concatenamento.


addEventAction(eventAction)

Aggiunge l'azione evento che può essere eseguita sul widget.

Parametri

NomeTipoDescrizione
eventActionEventActionIl EventAction da aggiungere.

Indietro

Widget : l'oggetto, per il concatenamento.


setId(id)

Imposta l'ID univoco assegnato utilizzato per identificare il widget da modificare. La mutazione dei widget è supportata solo nei componenti aggiuntivi.

Parametri

NomeTipoDescrizione
idStringL'ID del widget, con un limite di 64 caratteri e nel formato `[a-zA-Z0-9-]+`.

Indietro

Widget : questo oggetto, per il concatenamento.


setVisibility(visibility)

Imposta la visibilità del widget. Il valore predefinito è `VISIBLE`.

Parametri

NomeTipoDescrizione
visibilityVisibilityLa Visibility del widget.

Indietro

Widget : l'oggetto, per il concatenamento.


setWrapStyle(wrapStyle)

Imposta lo stile di ritorno a capo delle colonne, controlla il modo in cui la colonna viene ridimensionata in base alla larghezza dello schermo.

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

Parametri

NomeTipoDescrizione
wrapStyleWrapStyleLo stile di ritorno a capo da impostare per le colonne.

Indietro

Columns : questo oggetto, per il concatenamento.