Class TextParagraph

TextParagraph

أداة تعرض نصًا وتتيح تنسيق HTML الأساسي

متاحة لإضافات Google Workspace وتطبيقات Google Chat.

const textParagraph = CardService.newTextParagraph().setText(
    'This is a text paragraph widget. Multiple lines are allowed if needed.',
);

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
addEventAction(eventAction)	Widget	تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setId(id)	Widget	يضبط هذا الإجراء المعرّف الفريد الذي تمّ تعيينه والذي يُستخدَم لتحديد الأداة التي سيتمّ تغييرها.
setMaxLines(maxLines)	TextParagraph	تضبط هذه السمة الحد الأقصى لعدد أسطر النص المعروضة في الأداة.
setText(text)	TextParagraph	تضبط هذه السمة نص الفقرة.
setVisibility(visibility)	Widget	تضبط هذه السمة مستوى ظهور الأداة.

مستندات تفصيلية

addEventAction(eventAction)

تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.

المَعلمات

الاسم	النوع	الوصف
eventAction	EventAction	تمثّل هذه السمة EventAction المطلوب إضافتها.

الإرجاع

Widget — العنصر، للتسلسل

---

setId(id)

يضبط هذا الإجراء المعرّف الفريد الذي تمّ تعيينه والذي يُستخدَم لتحديد الأداة التي سيتمّ تغييرها. لا يمكن تغيير التطبيقات المصغّرة إلا في الإضافات.

المَعلمات

الاسم	النوع	الوصف
id	String	معرّف الأداة، ويمكن أن يتضمّن 64 حرفًا بحدّ أقصى وبالتنسيق `[a-zA-Z0-9-]+`.

الإرجاع

Widget: هذا العنصر، للتسلسل

---

setMaxLines(maxLines)

تضبط هذه السمة الحد الأقصى لعدد أسطر النص المعروضة في الأداة. إذا كان النص يتجاوز الحد الأقصى لعدد الأسطر المحدّد، يتم إخفاء المحتوى الزائد خلف زر "عرض المزيد". إذا كان النص يساوي الحد الأقصى لعدد الأسطر المحدّد أو أقصر منه، لن يظهر الزر "عرض المزيد".

متاحة لتطبيقات Google Chat. في الإصدار التجريبي من إضافات Google Workspace

معاينة المطور: يتوفّر كجزء من برنامج الاستخدام المبكر في 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: هذا العنصر، للتسلسل

---

setVisibility(visibility)

تضبط هذه السمة مستوى ظهور الأداة. القيمة التلقائية هي `VISIBLE`.

المَعلمات

الاسم	النوع	الوصف
visibility	Visibility	Visibility الأداة

الإرجاع

Widget — العنصر، للتسلسل