Class Columns

Colonne

Il widget Columns mostra fino a due colonne in una scheda o in una 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 viene visualizzata 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 viene visualizzata 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 interfacce utente del componente aggiuntivo 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 un Column al widget Colonne.
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 wrapping delle colonne, controlla il modo in cui la colonna viene ridimensionata in base alla larghezza dello schermo.

Documentazione dettagliata

addColumn(column)

Aggiunge un Column al widget Colonne. 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 Colonne.

Indietro

Columns: questo oggetto, per il concatenamento.

addEventAction(eventAction)

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

Parametri

NomeTipoDescrizione
eventActionEventActionEventAction 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
visibilityVisibilityIl Visibility del widget.

Indietro

Widget: l'oggetto, per il concatenamento.

setWrapStyle(wrapStyle)

Imposta lo stile di wrapping 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.