Class Columns

Colonnes

Le widget Columns affiche jusqu'à deux colonnes dans une fiche ou une boîte de dialogue. Vous pouvez ajouter des widgets à chaque Column. Ils s'affichent 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 les widgets entre les colonnes.

Les colonnes s'affichent 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 s'affiche sous la première :

• Sur le Web, la deuxième colonne s'affiche sous la première si la largeur de l'écran est inférieure ou égale à 480 pixels.
• Sur les appareils iOS, la deuxième colonne s'affiche sous la première si la largeur de l'écran est inférieure ou égale à 300 points.
• Sur les appareils Android, la deuxième colonne s'affiche sous la première 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. Les interfaces utilisateur de module complémentaire qui acceptent les colonnes incluent les suivantes :

• La boîte de dialogue qui s'affiche lorsque les utilisateurs ouvrent le module complémentaire à partir d'un brouillon d'e-mail.
• La boîte de dialogue qui s'affiche lorsque les utilisateurs ouvrent le module complémentaire à partir du menu Ajouter une pièce jointe dans un événement Google Agenda.

  // 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 une Column au widget Columns.
addEventAction(eventAction)	Widget	Ajoute l'action d'événement qui peut être effectuée sur le widget.
setId(id)	Widget	Définit l'ID unique attribué qui est utilisé pour identifier le widget à modifier.
setVisibility(visibility)	Widget	Définit la visibilité du widget.
setWrapStyle(wrapStyle)	Columns	Définit le style d'habillage des colonnes et contrôle la façon dont la colonne est redimensionnée en fonction de la largeur de l'écran.

Documentation détaillée

addColumn(column)

Ajoute une Column au widget Columns. Les colonnes s'affichent dans l'ordre dans lequel elles sont 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 Columns.

Renvois

Columns : cet objet, pour le chaînage.

---

addEventAction(eventAction)

Ajoute l'action d'événement qui peut être effectuée sur le widget.

Paramètres

Nom	Type	Description
eventAction	EventAction	Le EventAction à ajouter.

Renvois

Widget : l'objet, pour le chaînage.

---

setId(id)

Définit l'ID unique attribué qui est utilisé pour identifier le widget à modifier. La modification des widgets n'est possible que dans les modules complémentaires.

Paramètres

Nom	Type	Description
id	String	ID du widget, limité à 64 caractères et au format `[a-zA-Z0-9-]+`.

Renvois

Widget : cet objet, pour le chaînage.

---

setVisibility(visibility)

Définit la visibilité du widget. La valeur par défaut est `VISIBLE`.

Paramètres

Nom	Type	Description
visibility	Visibility	Visibility du widget.

Renvois

Widget : l'objet, pour le chaînage.

---

setWrapStyle(wrapStyle)

Définit le style d'habillage des colonnes et contrôle la façon dont la colonne est redimensionnée 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 d'habillage à définir pour les colonnes.

Renvois

Columns : cet objet, pour le chaînage.