Columns 위젯은 카드 또는 대화상자에 최대 2개의 열을 표시합니다. 각 Column에 위젯을 추가할 수 있습니다. 위젯은 지정된 순서대로 표시됩니다. Google Chat 앱의 예시는 열을 참고하세요.
각 열의 높이는 더 높은 열에 따라 결정됩니다. 예를 들어 첫 번째 열이 두 번째 열보다 높으면 두 열 모두 첫 번째 열의 높이를 갖습니다. 각 열에는 서로 다른 수의 위젯이 포함될 수 있으므로 열 사이에 행을 정의하거나 위젯을 정렬할 수 없습니다.
열이 나란히 표시됩니다. Horizontal 필드를 사용하여 각 열의 너비를 맞춤설정할 수 있습니다. 사용자의 화면 너비가 너무 좁으면 두 번째 열이 첫 번째 열 아래로 래핑됩니다.
- 웹에서는 화면 너비가 480픽셀 이하인 경우 두 번째 열이 래핑됩니다.
- iOS 기기에서 화면 너비가 300pt 이하인 경우 두 번째 열이 래핑됩니다.
- Android 기기에서 화면 너비가 320dp 이하이면 두 번째 열이 래핑됩니다.
Google Chat 앱 및 Google Workspace 부가기능에서 사용할 수 있습니다. 열을 지원하는 부가기능 UI는 다음과 같습니다.
- 사용자가 이메일 초안에서 부가기능을 열 때 표시되는 대화상자입니다.
- 사용자가 Google Calendar 일정의 첨부파일 추가 메뉴에서 부가기능을 열 때 표시되는 대화상자입니다.
// 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);
메서드
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
add | Columns | 열 위젯에 Column을 추가합니다. |
add | Widget | 위젯에서 실행할 수 있는 이벤트 작업을 추가합니다. |
set | Widget | 변형할 위젯을 식별하는 데 사용되는 할당된 고유 ID를 설정합니다. |
set | Widget | 위젯의 공개 상태를 설정합니다. |
set | Columns | 열의 래핑 스타일을 설정합니다. 화면 너비에 따라 열의 크기가 조정되는 방식을 제어합니다. |
자세한 문서
add Column(column)
add Event Action(eventAction)
위젯에서 실행할 수 있는 이벤트 작업을 추가합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
event | Event | 추가할 Event입니다. |
리턴
Widget - 연결을 위한 객체입니다.
set Id(id)
변형할 위젯을 식별하는 데 사용되는 할당된 고유 ID를 설정합니다. 위젯 변형은 부가기능에서만 지원됩니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
id | String | 위젯의 ID입니다. 64자(영문 기준)로 제한되며 `[a-zA-Z0-9-]+` 형식입니다. |
리턴
Widget - 연결을 위한 이 객체
set Visibility(visibility)
위젯의 공개 상태를 설정합니다. 기본값은 `VISIBLE`입니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
visibility | Visibility | 위젯의 Visibility입니다. |
리턴
Widget - 연결을 위한 객체입니다.