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');

روش‌ها

روش نوع بازگشتی شرح مختصر
set Image Alt Text(imageAltText) Card Header متن جایگزین برای تصویر سربرگ را تنظیم می‌کند.
set Image Style(imageStyle) Card Header میزان برش آیکون در سربرگ کارت را تنظیم می‌کند.
set Image Url(imageUrl) Card Header با ارائه URL یا رشته داده، تصویر را برای استفاده در هدر تنظیم می‌کند.
set Subtitle(subtitle) Card Header عنوان فرعی سربرگ کارت را تنظیم می‌کند.
set Title(title) Card Header عنوان سربرگ کارت را تنظیم می‌کند.

مستندات دقیق

setImageAltText(imageAltText)

متن جایگزین برای تصویر سربرگ را تنظیم می‌کند.

پارامترها

نام نوع توضیحات
image Alt Text String متن جایگزین برای تصویر هدر.

بازگشت

CardHeader — این شیء، برای زنجیره‌سازی.

setImageStyle(imageStyle)

میزان برش آیکون در سربرگ کارت را تنظیم می‌کند. پیش‌فرض بدون برش است. اختیاری.

پارامترها

نام نوع توضیحات
image Style Image Style تنظیم سبک.

بازگشت

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

پارامترها

نام نوع توضیحات
image Url String آدرس URL تصویر میزبانی شده برای استفاده، یا یک رشته تصویر کدگذاری شده.

بازگشت

CardHeader — این شیء، برای زنجیره‌سازی.

setSubtitle(subtitle)

عنوان فرعی سربرگ کارت را تنظیم می‌کند. اختیاری.

پارامترها

نام نوع توضیحات
subtitle String متن زیرنویس هدر.

بازگشت

CardHeader — این شیء، برای زنجیره‌سازی.

setTitle(title)

عنوان سربرگ کارت را تنظیم می‌کند. الزامی است.

پارامترها

نام نوع توضیحات
title String متن سربرگ.

بازگشت

CardHeader — این شیء، برای زنجیره‌سازی.