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 ; les widgets apparaissent dans l'ordre dans lequel ils sont spécifiés. Par exemple, dans Pour 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 colonne, 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 est renvoyé à la ligne 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 renvoie une valeur automatique si la largeur de l'écran est inférieure ou égale à 300. ptie.
  • Sur les appareils Android, la deuxième colonne renvoie automatiquement à une valeur 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 des modules complémentaires compatibles sont les suivantes:

  • Boîte de dialogue qui s'affiche 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 une é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.
setWrapStyle(wrapStyle)ColumnsDé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 où elles sont 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 : objet utilisé 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 sont redimensionnées en fonction de la largeur de l'écran.

const columns = CardService.newColumns()
    .addColumn(CardService.newColumn())
    .setWrapStyle(CardService.WrapStyle.WRAP);

Paramètres

NomTypeDescription
wrapStyleWrapStyleStyle de retour à la ligne à définir pour les colonnes.

Renvois

Columns : objet utilisé pour le chaînage.