דף זה תורגם על ידי Cloud Translation API.

Class CardHeader

הכותרת של 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 – האובייקט הזה, לשרשור.