Class CardHeader

CardHeader

تمثّل هذه السمة عنوان Card.

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

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

تضبط هذه السمة النص البديل لصورة العنوان.

المَعلمات

الاسم	النوع	الوصف
imageAltText	String	النص البديل لصورة العنوان

الإرجاع

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

---

setImageStyle(imageStyle)

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

المَعلمات

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

الإرجاع

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.
const imageBytes = DriveApp.getFileById('123abc').getBlob().getBytes();
const encodedImageURL =
    `data:image/jpeg;base64,${Utilities.base64Encode(imageBytes)}`;

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

المَعلمات

الاسم	النوع	الوصف
imageUrl	String	تمثّل هذه السمة عنوان URL لصورة مستضافة سيتم استخدامها، أو سلسلة صور مرمّزة.

الإرجاع

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

---

setSubtitle(subtitle)

تضبط هذه السمة العنوان الفرعي لعنوان البطاقة. اختياريّ.

المَعلمات

الاسم	النوع	الوصف
subtitle	String	نص العنوان الفرعي للرأس

الإرجاع

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

---

setTitle(title)

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

المَعلمات

الاسم	النوع	الوصف
title	String	نص العنوان

الإرجاع

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