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 auront 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 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 passe sous la première :

  • Sur le Web, la deuxième colonne s'affiche sur plusieurs lignes si la largeur de l'écran est inférieure ou égale à 480 pixels.
  • Sur les appareils iOS, la deuxième colonne s'affiche sur plusieurs lignes si la largeur de l'écran est inférieure ou égale à 300 points.
  • Sur les appareils Android, la deuxième colonne s'affiche sur plusieurs lignes 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 modules complémentaires compatibles avec les colonnes sont les suivantes :

  • Boîte de dialogue affichée lorsque les utilisateurs ouvrent le module complémentaire à partir d'un brouillon d'e-mail.
  • Boîte de dialogue affichée 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éthodeType renvoyéBrève description
addColumn(column)ColumnsAjoute un Column au widget "Colonnes".
addEventAction(eventAction)WidgetAjoute l'action d'événement qui peut être effectuée sur le widget.
setId(id)WidgetDéfinit l'ID unique attribué qui est utilisé pour identifier le widget à modifier.
setVisibility(visibility)WidgetDéfinit la visibilité du widget.
setWrapStyle(wrapStyle)ColumnsDé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 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

NomTypeDescription
columnColumnColonne enfant à ajouter au widget "Colonnes".

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

NomTypeDescription
eventActionEventActionEventAction à ajouter.

Renvois

Widget : objet pour le chaînage.

setId(id)

Définit l'ID unique attribué qui est utilisé pour identifier le widget à modifier. La mutation de widget n'est disponible que dans les modules complémentaires.

Paramètres

NomTypeDescription
idStringID 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

NomTypeDescription
visibilityVisibilityLe Visibility du widget.

Renvois

Widget : 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

NomTypeDescription
wrapStyleWrapStyleStyle d'habillage à définir pour les colonnes.

Renvois

Columns : cet objet, pour le chaînage.