Le widget Columns affiche jusqu'à deux colonnes dans une fiche ou une boîte de dialogue. Vous pouvez ajouter des widgets à chaque Column. Ils apparaissent dans l'ordre dans lequel ils sont spécifiés. Pour obtenir un exemple dans les applications Google Chat, consultez Colonnes.
La hauteur de chaque colonne est déterminée par la colonne la plus haute. Par exemple, si la première colonne est plus haute que la deuxième, les deux colonnes ont la hauteur de la première. Étant donné que chaque colonne peut contenir un nombre différent de widgets, vous ne pouvez pas définir de lignes ni aligner de widgets entre les colonnes.
Les colonnes sont affichées côte à côte. Vous pouvez personnaliser la largeur de chaque colonne à l'aide du champ HorizontalSizeStyle. Si la largeur de l'écran de l'utilisateur est trop étroite, la deuxième colonne est placée sous la première:
- Sur le Web, la deuxième colonne renvoie à la ligne un retour à la ligne si la largeur de l'écran est inférieure ou égale à 480 pixels.
- Sur les appareils iOS, la deuxième colonne est encapsulée si la largeur de l'écran est inférieure ou égale à 300 pts.
- Sur les appareils Android, la deuxième colonne est encapsulée si la largeur de l'écran est inférieure ou égale à 320 dp.
Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.
// 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éthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
addColumn(column) | Columns | Ajoute un Column au widget Colonnes. |
setWrapStyle(wrapStyle) | Columns | Définit le style de retour à la ligne des colonnes et contrôle le redimensionnement de la colonne en fonction de la largeur de l'écran. |
Documentation détaillée
addColumn(column)
Ajoute un Column au widget Colonnes. Les colonnes s'affichent dans l'ordre dans lequel elles ont été ajoutées. Vous pouvez ajouter jusqu'à deux colonnes.
const columns = CardService.newColumns()
.addColumn(CardService.newColumn());
Paramètres
| Nom | Type | Description |
|---|---|---|
column | Column | Colonne enfant à ajouter au widget Colonnes. |
Renvois
Columns : objet pour le chaînage.
setWrapStyle(wrapStyle)
Définit le style de retour à la ligne des colonnes et contrôle le redimensionnement de la colonne en fonction de la largeur de l'écran.
const columns = CardService.newColumns()
.addColumn(CardService.newColumn())
.setWrapStyle(CardService.WrapStyle.WRAP);
Paramètres
| Nom | Type | Description |
|---|---|---|
wrapStyle | WrapStyle | Style de retour à la ligne à définir pour les colonnes. |
Renvois
Columns : objet pour le chaînage.