تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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: هذا العنصر، لإنشاء سلسلة.