Class TextParagraph
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
النصالفقرة
أداة تعرض نصًا وتتوافق مع تنسيق HTML الأساسي
تتوفّر هذه الميزة لإضافات Google Workspace وتطبيقات Google Chat.
const textParagraph = CardService.newTextParagraph().setText(
'This is a text paragraph widget. Multiple lines are allowed if needed.',
);
مستندات تفصيلية
setMaxLines(maxLines)
لتحديد الحد الأقصى لعدد أسطر النص المعروضة في التطبيق المصغّر إذا كان النص يتجاوز
الحد الأقصى المحدّد لعدد الأسطر، يتم إخفاء المحتوى الزائد خلف زر "عرض المزيد"
. إذا كان النص يساوي الحد الأقصى المحدّد لعدد الأسطر أو أقصر منه، لن يتم عرض الزر "عرض
المزيد".
تتوفّر هذه الميزة لتطبيقات Google Chat. في الإصدار التجريبي المخصّص للمطوّرين لإضافات Google Workspace
const textParagraph =
CardService.newTextParagraph()
.setText(
'This is a text paragraph widget. Multiple lines are allowed if needed.',
)
.setMaxLines(1);
المعلمات
| الاسم | النوع | الوصف |
maxLines | Integer | الحد الأقصى لعدد أسطر النص المعروضة |
الإرجاع
TextParagraph: هذا العنصر، لإنشاء سلسلة.
setText(text)
لضبط نص الفقرة مطلوب.
المعلمات
| الاسم | النوع | الوصف |
text | String | النص المراد عرضه |
الإرجاع
TextParagraph: هذا العنصر، لإنشاء سلسلة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eTextParagraph\u003c/code\u003e widget displays text with basic HTML formatting support.\u003c/p\u003e\n"],["\u003cp\u003eIt is usable in Google Workspace Add-ons and Google Chat apps.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can set the displayed text using the \u003ccode\u003esetText()\u003c/code\u003e method and can chain additional methods for further customization.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esetText()\u003c/code\u003e method requires a string argument representing the desired text content.\u003c/p\u003e\n"]]],["The `TextParagraph` widget displays text with basic HTML formatting in Google Workspace add-ons and Google Chat apps. Key actions include `setText(text)` to define the displayed text and `setMaxLines(maxLines)` to limit the visible lines; exceeding this limit adds a \"show more\" button. `setMaxLines` is in developer preview for Google Workspace and available for Google Chat, whereas `setText` is fully available. Both methods return the `TextParagraph` object to enable method chaining.\n"],null,["# Class TextParagraph\n\nTextParagraph\n\nA widget that displays text and supports [basic HTML formatting](/gmail/add-ons/concepts/widgets#text_formatting).\n\nAvailable for Google Workspace add-ons and Google Chat apps.\n\n```javascript\nconst textParagraph = CardService.newTextParagraph().setText(\n 'This is a text paragraph widget. Multiple lines are allowed if needed.',\n);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|------------------------------------------------|--------------------|----------------------------------------------------------------------------|\n| [setMaxLines(maxLines)](#setMaxLines(Integer)) | [TextParagraph](#) | Sets the maximum number of lines of text that are displayed in the widget. |\n| [setText(text)](#setText(String)) | [TextParagraph](#) | Sets the text of the paragraph. |\n\nDetailed documentation\n----------------------\n\n### `set``Max``Lines(maxLines)`\n\nSets the maximum number of lines of text that are displayed in the widget. If the text exceeds\nthe specified maximum number of lines, the excess content is concealed behind a \"show more\"\nbutton. If the text is equal or shorter than the specified maximum number of lines, a \"show\nmore\" button isn't displayed.\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 textParagraph =\n CardService.newTextParagraph()\n .setText(\n 'This is a text paragraph widget. Multiple lines are allowed if needed.',\n )\n .setMaxLines(1);\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------|-----------|---------------------------------------------------------|\n| `max``Lines` | `Integer` | The maximum number of lines of text that are displayed. |\n\n#### Return\n\n\n[TextParagraph](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Text(text)`\n\nSets the text of the paragraph. Required.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|----------------------|\n| `text` | `String` | The text to display. |\n\n#### Return\n\n\n[TextParagraph](#) --- This object, for chaining."]]
