Class CardSection
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
카드섹션
카드 섹션은 위젯 그룹을 보유하고 위젯 그룹 간에 시각적 구분을 제공합니다.
Google Workspace 부가기능 및 Google Chat 앱에서 사용할 수 있습니다.
const image = CardService.newImage();
// Build image ...
const textParagraph = CardService.newTextParagraph();
// Build text paragraph ...
const cardSection = CardService.newCardSection()
.setHeader('Section header')
.addWidget(image)
.addWidget(textParagraph);
자세한 문서
setCollapseControl(collapseControl)
섹션의 맞춤설정 가능한 펼치기 및 접기 버튼을 설정합니다. 이 버튼은 섹션을 접을 수 있는 경우에만 표시됩니다. 이 필드를 설정하지 않으면 기본 버튼이 사용됩니다.
Google Chat 앱에서 사용할 수 있습니다. Google Workspace 부가기능 개발자 프리뷰
const collapseButton =
CardService.newTextButton()
.setTextButtonStyle(CardService.TextButtonStyle.BORDERLESS)
.setText('show less');
const expandButton =
CardService.newImageButton()
.setImageButtonStyle(CardService.ImageButtonStyle.FILLED)
.setMaterialIcon(CardService.newMaterialIcon().setName('bug_report'));
const collapsibleSection =
CardService.newCardSection()
.setCollapsible(true)
.setNumUncollapsibleWidgets(1)
.setCollapseControl(
CardService.newCollapseControl()
.setHorizontalAlign(CardService.HorizontalAlignment.CENTER)
.setCollapseButton(collapseButton)
.setExpandButton(expandButton),
);
매개변수
리턴
CardSection: 연결을 위한 객체입니다.
setCollapsible(collapsible)
섹션을 접을 수 있는지 여부를 설정합니다.
매개변수
| 이름 | 유형 | 설명 |
collapsible | Boolean | 접을 수 있는 설정 |
리턴
CardSection: 연결을 위한 객체입니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eCard sections visually separate groups of widgets within Google Workspace add-ons and Chat apps.\u003c/p\u003e\n"],["\u003cp\u003eThey can be customized with headers and configured to be collapsible, showing a specified number of widgets when collapsed.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can easily add widgets like images and text paragraphs to card sections using Apps Script.\u003c/p\u003e\n"],["\u003cp\u003eCard sections enhance the organization and user experience by grouping related content within cards.\u003c/p\u003e\n"]]],[],null,["# Class CardSection\n\nCardSection\n\nA card section holds groups of widgets and provides visual separation between them.\n\nAvailable for Google Workspace add-ons and Google Chat apps.\n\n```javascript\nconst image = CardService.newImage();\n// Build image ...\nconst textParagraph = CardService.newTextParagraph();\n// Build text paragraph ...\n\nconst cardSection = CardService.newCardSection()\n .setHeader('Section header')\n .addWidget(image)\n .addWidget(textParagraph);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------------------------------------------------------------------------|------------------|---------------------------------------------------------------------------------|\n| [addWidget(widget)](#addWidget(Widget)) | [CardSection](#) | Adds the given widget to this section. |\n| [setCollapseControl(collapseControl)](#setCollapseControl(CollapseControl)) | [CardSection](#) | Sets the customizable expand and collapse buttons of the section. |\n| [setCollapsible(collapsible)](#setCollapsible(Boolean)) | [CardSection](#) | Sets whether the section can be collapsed. |\n| [setHeader(header)](#setHeader(String)) | [CardSection](#) | Sets the header of the section. |\n| [setNumUncollapsibleWidgets(numUncollapsibleWidgets)](#setNumUncollapsibleWidgets(Integer)) | [CardSection](#) | Sets the number of widgets that are still shown when this section is collapsed. |\n\nDetailed documentation\n----------------------\n\n### `add``Widget(widget)`\n\nAdds the given widget to this section. Widgets are shown in the order they were added. You\ncan't add more than 100 widgets to a card section.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|------------------------------------------------------|---------------------------------|\n| `widget` | [Widget](/apps-script/reference/card-service/widget) | A widget to add to the section. |\n\n#### Return\n\n\n[CardSection](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Collapse``Control(collapseControl)`\n\nSets the customizable expand and collapse buttons of the section. These buttons are shown only\nif the section is collapsible. If this field isn't set, default buttons are used.\n\nAvailable for Google Chat apps. In developer preview for Google Workspace add-ons.\n\n\n| **Developer Preview:** Available as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), which grants early access to certain features.\n\n\u003cbr /\u003e\n\n```javascript\nconst collapseButton =\n CardService.newTextButton()\n .setTextButtonStyle(CardService.TextButtonStyle.BORDERLESS)\n .setText('show less');\n\nconst expandButton =\n CardService.newImageButton()\n .setImageButtonStyle(CardService.ImageButtonStyle.FILLED)\n .setMaterialIcon(CardService.newMaterialIcon().setName('bug_report'));\n\nconst collapsibleSection =\n CardService.newCardSection()\n .setCollapsible(true)\n .setNumUncollapsibleWidgets(1)\n .setCollapseControl(\n CardService.newCollapseControl()\n .setHorizontalAlign(CardService.HorizontalAlignment.CENTER)\n .setCollapseButton(collapseButton)\n .setExpandButton(expandButton),\n );\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|---------------------|-------------------------------------------------------------------------|-------------------------------|\n| `collapse``Control` | [CollapseControl](/apps-script/reference/card-service/collapse-control) | The collapse control setting. |\n\n#### Return\n\n\n[CardSection](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Collapsible(collapsible)`\n\nSets whether the section can be collapsed.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------------|-----------|--------------------------|\n| `collapsible` | `Boolean` | The collapsible setting. |\n\n#### Return\n\n\n[CardSection](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Header(header)`\n\nSets the header of the section. Optional.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|----------|------------------|\n| `header` | `String` | The header text. |\n\n#### Return\n\n\n[CardSection](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Num``Uncollapsible``Widgets(numUncollapsibleWidgets)`\n\nSets the number of widgets that are still shown when this section is collapsed. The widgets\nshown are always the first ones that were added.\n\n#### Parameters\n\n| Name | Type | Description |\n|-------------------------------|-----------|--------------------------------|\n| `num``Uncollapsible``Widgets` | `Integer` | The number of widgets to show. |\n\n#### Return\n\n\n[CardSection](#) --- This object, for chaining."]]
