Cette page a été traduite par l'API Cloud Translation.

Class Columns

Le widget Columns affiche jusqu'à deux colonnes dans une fiche ou une boîte de dialogue. Vous pouvez ajouter des widgets à chaque Column. Les widgets s'affichent dans l'ordre dans lequel ils sont spécifiés. Pour obtenir un exemple dans les applications Google Chat, consultez la section 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 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 se plie sous la première:

Sur le Web, la deuxième colonne se plie si la largeur de l'écran est inférieure ou égale à 480 pixels.
Sur les appareils iOS, la deuxième colonne se plie si la largeur de l'écran est inférieure ou égale à 300 pt.
Sur les appareils Android, la deuxième colonne se plie 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 UI de modules complémentaires compatibles avec les colonnes incluent 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 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 un `Column` au widget "Colonnes".
`setWrapStyle(wrapStyle)`	`Columns`	Définit le style de retour à la ligne des colonnes et contrôle la façon dont les colonnes se redimensionnent 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 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" (Colonnes).

Renvois

Columns : cet objet, pour le chaînage.

`setWrapStyle(wrapStyle)`

Définit le style de retour à la ligne des colonnes et contrôle la façon dont les colonnes se redimensionnent 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 : cet objet, pour le chaînage.