تمثّل هذه السمة عنوان Card
.
متاحة لإضافات Google Workspace وتطبيقات Google Chat.
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)
لضبط النص البديل لصورة العنوان.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
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. 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).
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
imageUrl | String | عنوان URL لصورة مستضافة لاستخدامها أو سلسلة صورة مشفّرة. |
استرجاع الكرة
CardHeader
: هذا الكائن، للتسلسل.
setSubtitle(subtitle)
لضبط العنوان الفرعي لرأس البطاقة. اختياريّ.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
subtitle | String | تمثّل هذه السمة نص العنوان الفرعي للعنوان. |
استرجاع الكرة
CardHeader
: هذا الكائن، للتسلسل.
setTitle(title)
لضبط عنوان عنوان البطاقة. مطلوبة.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | نص العنوان. |
استرجاع الكرة
CardHeader
: هذا الكائن، للتسلسل.