Class ChipList
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قائمة الشرائح
يحتوي على مجموعة من Chip عناصر يتم عرضها في صف، ويتم لفها إلى السطر التالي لتكون
قابلة للانتقال أفقيًا.
تتوفّر هذه الميزة لتطبيقات Google Chat. في الإصدار التجريبي المخصّص للمطوّرين لإضافات Google Workspace
const chip = CardService.newChip();
// Finish building the text chip...
const chipList = CardService.newChipList()
.setLayout(CardService.ChipListLayout.WRAPPED)
.addChip(chip);
مستندات تفصيلية
addChip(chip)
لإضافة شريحة
المعلمات
| الاسم | النوع | الوصف |
chip | Chip | الشريحة المطلوب إضافتها |
الإرجاع
ChipList: هذا العنصر، لإنشاء سلسلة.
setLayout(layout)
لضبط تنسيق قائمة الشرائح وفي حال عدم ضبطه، يتم ضبطه تلقائيًا على تنسيق ChipListLayout.WRAPPED.
const chip = CardService.newChip();
// Finish building the text chip...
const chipList =
CardService.newChipList()
.setLayout(CardService.ChipListLayout.HORIZONTAL_SCROLLABLE)
.addChip(chip);
المعلمات
الإرجاع
ChipList: هذا العنصر، لإنشاء سلسلة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eChipList displays a set of Chip objects in a row, wrapping to the next line or horizontally scrolling.\u003c/p\u003e\n"],["\u003cp\u003eIt's available for Google Chat apps and in developer preview for Google Workspace Add-ons.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use \u003ccode\u003eaddChip()\u003c/code\u003e to add chips and \u003ccode\u003esetLayout()\u003c/code\u003e to configure the layout of the ChipList.\u003c/p\u003e\n"]]],[],null,["# Class ChipList\n\nChipList\n\nHolds a set of [Chip](/apps-script/reference/card-service/chip) objects that are displayed in a row, wrapping to the next line to\nhorizontal scrollable.\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 chip = CardService.newChip();\n// Finish building the text chip...\n\nconst chipList = CardService.newChipList()\n .setLayout(CardService.ChipListLayout.WRAPPED)\n .addChip(chip);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------|---------------|----------------------------|\n| [addChip(chip)](#addChip(Chip)) | [ChipList](#) | Adds a chip. |\n| [setLayout(layout)](#setLayout(ChipListLayout)) | [ChipList](#) | Sets the chip list layout. |\n\nDetailed documentation\n----------------------\n\n### `add``Chip(chip)`\n\nAdds a chip.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|--------------------------------------------------|------------------|\n| `chip` | [Chip](/apps-script/reference/card-service/chip) | The chip to add. |\n\n#### Return\n\n\n[ChipList](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Layout(layout)`\n\nSets the chip list layout. If unset, it defaults to [ChipListLayout.WRAPPED](/apps-script/reference/card-service/chip-list-layout#WRAPPED) layout.\n\n```javascript\nconst chip = CardService.newChip();\n// Finish building the text chip...\n\nconst chipList =\n CardService.newChipList()\n .setLayout(CardService.ChipListLayout.HORIZONTAL_SCROLLABLE)\n .addChip(chip);\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|------------------------------------------------------------------------|-----------------------|\n| `layout` | [ChipListLayout](/apps-script/reference/card-service/chip-list-layout) | The chip list layout. |\n\n#### Return\n\n\n[ChipList](#) --- This object, for chaining."]]
