Class CardHeader

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
CardHeader

عنوان Card.

var cardHeader = CardService.newCardHeader()
    .setTitle("Card header title")
    .setSubtitle("Card header subtitle")
    .setImageStyle(CardService.ImageStyle.CIRCLE)
    .setImageUrl("https://image.png");

الطُرق

الطريقةنوع الإرجاعوصف قصير
setImageAltText(imageAltText)CardHeaderلضبط النص البديل لصورة العنوان.
setImageStyle(imageStyle)CardHeaderلضبط اقتصاص الرمز في عنوان البطاقة.
setImageUrl(imageUrl)CardHeaderتضبط الصورة التي سيتم استخدامها في العنوان من خلال تقديم عنوان URL أو سلسلة البيانات.
setSubtitle(subtitle)CardHeaderتعيّن العنوان الفرعي لرأس البطاقة.
setTitle(title)CardHeaderتُحدّد هذه السياسة عنوان عنوان البطاقة.

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

setImageAltText(imageAltText)

لضبط النص البديل لصورة العنوان.

المعلّمات

الاسمالنوعالوصف
imageAltTextStringالنص البديل لصورة العنوان.

تذكرة ذهاب وعودة

CardHeader — هذا العنصر للسلاسل.


setImageStyle(imageStyle)

لضبط اقتصاص الرمز في عنوان البطاقة. الإعداد التلقائي هو عدم الاقتصاص. اختياريّ.

المعلّمات

الاسمالنوعالوصف
imageStyleImageStyleإعداد النمط

تذكرة ذهاب وعودة

CardHeader — هذا العنصر للسلاسل.


setImageUrl(imageUrl)

تضبط الصورة التي سيتم استخدامها في العنوان من خلال تقديم عنوان URL أو سلسلة البيانات.

يمكن أن يكون عنوان URL المُقدَّم إما عنوان URL متاحًا للجميع أو سلسلة صورة مرمَّزة base64. للحصول على الرمز الثاني، يمكنك استخدام الرمز التالي لإنشاء سلسلة صورة مشفّرة من صورة في Google Drive، ثم تخزين هذه السلسلة لاستخدامها لاحقًا مع setImageUrl(imageUrl). تمنع هذه الطريقة الإضافات من الوصول إلى عنوان URL متاح للجميع للصور:

// The following assumes you have the image to use in Google Drive and have its ID.
var imageBytes = DriveApp.getFileById(imageID).getBlob().getBytes();
var encodedImageURL = "data:image/jpeg;base64," + Utilities.base64Encode(imageBytes);

// You can store encodeImageURL and use it as a parameter to CardHeader.setImageUrl(imageUrl).

المعلّمات

الاسمالنوعالوصف
imageUrlStringعنوان URL لصورة مستضافة لاستخدامها أو سلسلة صورة مشفّرة.

تذكرة ذهاب وعودة

CardHeader — هذا العنصر للسلاسل.


setSubtitle(subtitle)

تعيّن العنوان الفرعي لرأس البطاقة. اختياريّ.

المعلّمات

الاسمالنوعالوصف
subtitleStringنص العنوان الفرعي للعنوان.

تذكرة ذهاب وعودة

CardHeader — هذا العنصر للسلاسل.


setTitle(title)

تُحدّد هذه السياسة عنوان عنوان البطاقة. مطلوبة.

المعلّمات

الاسمالنوعالوصف
titleStringنص العنوان.

تذكرة ذهاب وعودة

CardHeader — هذا العنصر للسلاسل.