Class Columns

열

Columns 위젯은 카드 또는 대화상자에 열을 최대 2개까지 표시합니다. 각 Column에 위젯을 추가할 수 있습니다. 위젯은 지정된 순서대로 표시됩니다. Google Chat 앱의 예는 열을 참조하세요.

각 열의 높이는 더 큰 열에 따라 결정됩니다. 예를 들어 첫 번째 열의 높이가 두 번째 열보다 크면 두 열 모두 첫 번째 열의 높이가 됩니다. 각 열에는 서로 다른 수의 위젯이 포함될 수 있으므로 행을 정의하거나 열 간에 위젯을 정렬할 수 없습니다.

열은 나란히 표시됩니다. HorizontalSizeStyle 필드를 사용하여 각 열의 너비를 맞춤설정할 수 있습니다. 사용자의 화면 너비가 너무 좁으면 두 번째 열이 첫 번째 열 아래로 래핑됩니다.

  • 웹에서 화면 너비가 480픽셀 이하인 경우 두 번째 열이 래핑됩니다.
  • iOS 기기에서는 화면 너비가 300pt 이하인 경우 두 번째 열이 줄바꿈됩니다.
  • Android 기기에서는 화면 너비가 320dp 이하인 경우 두 번째 열이 래핑됩니다.

Google Chat 앱 및 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);

방법

메서드반환 유형간략한 설명
addColumn(column)Columns열 위젯에 Column를 추가합니다.
setWrapStyle(wrapStyle)Columns열의 래핑 스타일을 설정하고 화면 너비에 따라 열의 크기가 조절되는 방식을 제어합니다.

자세한 문서

addColumn(column)

열 위젯에 Column를 추가합니다. 열은 추가된 순서대로 표시됩니다. 열은 최대 2개까지 추가할 수 있습니다. 

const columns = CardService.newColumns()
    .addColumn(CardService.newColumn());

매개변수

이름유형설명
columnColumn열 위젯에 추가할 하위 열입니다.

리턴

Columns: 체이닝용 객체입니다.

setWrapStyle(wrapStyle)

열의 래핑 스타일을 설정하고 화면 너비에 따라 열의 크기가 조절되는 방식을 제어합니다. 

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

매개변수

이름유형설명
wrapStyleWrapStyle열에 설정할 래핑 스타일입니다.

리턴

Columns: 체이닝용 객체입니다.