Class 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). تمنع هذه الطريقة إضافة Chrome من الوصول إلى عنوان 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: هذا العنصر، لإنشاء سلسلة.