Class 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)

تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على الأداة.

المعلمات

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

الإرجاع

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


setId(id)

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

المعلمات

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

الإرجاع

Widget: هذا الكائن، للتسلسل


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);

المعلمات

الاسمالنوعالوصف
maxLinesIntegerالحد الأقصى لعدد أسطر النص التي يتم عرضها

الإرجاع

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


setText(text)

تضبط هذه السمة نص الفقرة. الحقل مطلوب.

المعلمات

الاسمالنوعالوصف
textStringالنص المراد عرضه.

الإرجاع

TextParagraph: هذا الكائن، للتسلسل


setVisibility(visibility)

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

المعلمات

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

الإرجاع

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