Class Carousel
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
轮播界面
轮播界面（也称为滑块）会旋转并以幻灯片格式显示微件列表，并提供用于导航到上一个或下一个微件的按钮。
适用于 Google Workspace 插件和 Google Chat 应用。
const carousel =
CardService.newCarousel()
.addCarouselCard(CardService.newCarouselCard().addWidget(
CardService.newTextParagraph().setText('The first text paragraph in carousel')))
.addCarouselCard(CardService.newCarouselCard().addWidget(
CardService.newTextParagraph().setText('The second text paragraph in carousel')))
.addCarouselCard(CardService.newCarouselCard().addWidget(
CardService.newTextParagraph().setText('The third text paragraph in carousel')))
详细文档
addCarouselCard(card)
添加轮播卡片。
const carousel =
CardService.newCarousel()
.addCarouselCard(CardService.newCarouselCard().addWidget(
CardService.newTextParagraph().setText('The first text paragraph in carousel')));
参数
返回
Carousel - 此对象，用于链式调用。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003eCarousel, also known as a slider, displays widgets in a rotating slideshow format with navigation buttons.\u003c/p\u003e\n"],["\u003cp\u003eCarousels are available for use in Google Workspace add-ons and Google Chat apps.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eaddCarouselCard(card)\u003c/code\u003e method is used to add a carousel card to the carousel, and it returns the Carousel object for chaining.\u003c/p\u003e\n"],["\u003cp\u003eCarousels are currently part of the Google Workspace Developer Preview Program, providing early access to this feature.\u003c/p\u003e\n"]]],["Carousel, or slider, displays widgets in a slideshow format, navigable via buttons. It's available for Google Workspace add-ons and Google Chat apps. Developers use `CardService.newCarousel()` to create it. `addCarouselCard(card)` method adds individual cards, such as text paragraphs, to the carousel. Each card can be created using `CardService.newCarouselCard()`. This method returns the Carousel object, allowing for chaining of card additions. This is available in the Google Workspace Developer Preview Program.\n"],null,["# Class Carousel\n\nCarousel\n\nCarousel, also known as slider, rotates and displays a list of widgets in a slideshow format,\nwith buttons navigating to the previous or next widget.\n\nAvailable for Google Workspace add-ons and Google Chat apps.\n\n```javascript\nconst carousel =\n CardService.newCarousel()\n .addCarouselCard(CardService.newCarouselCard().addWidget(\n CardService.newTextParagraph().setText('The first text paragraph in carousel')))\n .addCarouselCard(CardService.newCarouselCard().addWidget(\n CardService.newTextParagraph().setText('The second text paragraph in carousel')))\n .addCarouselCard(CardService.newCarouselCard().addWidget(\n CardService.newTextParagraph().setText('The third text paragraph in carousel')))\n```\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### Methods\n\n| Method | Return type | Brief description |\n|---------------------------------------------------------|---------------|-----------------------|\n| [addCarouselCard(card)](#addCarouselCard(CarouselCard)) | [Carousel](#) | Adds a carousel card. |\n\nDetailed documentation\n----------------------\n\n### `add``Carousel``Card(card)`\n\nAdds a carousel card.\n\n```javascript\nconst carousel =\n CardService.newCarousel()\n .addCarouselCard(CardService.newCarouselCard().addWidget(\n CardService.newTextParagraph().setText('The first text paragraph in carousel')));\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|-------------------------------------------------------------------|---------------------------|\n| `card` | [CarouselCard](/apps-script/reference/card-service/carousel-card) | The carousel card to add. |\n\n#### Return\n\n\n[Carousel](#) --- This object, for chaining."]]
