Class CardHeader

CardHeader

Card 的标头。

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	通过提供网址或数据字符串，设置要在标头中使用的图片。
setSubtitle(subtitle)	CardHeader	设置卡片标题的副标题。
setTitle(title)	CardHeader	设置卡片标题。

详细文档

setImageAltText(imageAltText)

设置标题图片的替代文字。

参数

名称	类型	说明
imageAltText	String	标题图片的替代文字。

返回

CardHeader - 此对象，用于实现链式连接。

---

setImageStyle(imageStyle)

设置卡片标题中图标的剪裁。默认为不剪裁。选填。

参数

名称	类型	说明
imageStyle	ImageStyle	样式设置。

返回

CardHeader - 此对象，用于实现链式连接。

---

setImageUrl(imageUrl)

通过提供图片的网址或数据字符串，设置要在标头中使用的图片。

提供的网址可以是可公开访问的网址，也可以是 base64 编码的图片字符串。 若想获取后者，您可以使用以下代码基于 Google 云端硬盘中的图片创建编码后的图片字符串，然后存储该字符串以供日后与 setImageUrl(imageUrl) 搭配使用。使用此方法时，插件无需访问公开提供的图片网址：

// 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	要使用的托管图片的网址，或编码图片字符串。

返回

CardHeader - 此对象，用于实现链式连接。

---

setSubtitle(subtitle)

设置卡片标题的副标题。选填。

参数

名称	类型	说明
subtitle	String	标题副标题文字。

返回

CardHeader - 此对象，用于实现链式连接。

---

setTitle(title)

设置卡片标题。必需。

参数

名称	类型	说明
title	String	标题文字。

返回

CardHeader - 此对象，用于实现链式连接。