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
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
add | Columns | Aggiunge una Column al widget Columns. |
add | Widget | Aggiunge l'azione evento che può essere eseguita sul widget. |
set | Widget | Imposta l'ID univoco assegnato utilizzato per identificare il widget da modificare. |
set | Widget | Imposta la visibilità del widget. |
set | Columns | Imposta 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
| Nome | Tipo | Descrizione |
|---|---|---|
column | Column | Una 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
| Nome | Tipo | Descrizione |
|---|---|---|
event | Event | Il Event 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
| Nome | Tipo | Descrizione |
|---|---|---|
id | String | L'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
| Nome | Tipo | Descrizione |
|---|---|---|
visibility | Visibility | La 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
| Nome | Tipo | Descrizione |
|---|---|---|
wrap | Wrap | Lo stile di ritorno a capo da impostare per le colonne. |
Indietro
Columns : questo oggetto, per il concatenamento.