支持所有 Google 字体图标的对象。
适用于 Google Workspace 插件和 Google Chat 应用。
const materialIcon = CardService.newMaterialIcon() .setName('search') .setFill(true) .setWeight(400) .setGrade(0);
方法
方法 | 返回类型 | 简介 |
---|---|---|
setFill(fill) | MaterialIcon | 图标是否以填充状态呈现。 |
setGrade(grade) | MaterialIcon | Weight 和 Grade 会影响符号的粗细。 |
setName(name) | MaterialIcon | 设置图标的名称。 |
setWeight(weight) | MaterialIcon | 图标的描边粗细。 |
详细文档
setFill(fill)
图标是否以填充状态呈现。默认值为 false
。
如需预览不同的图标设置,请前往 Google 字体图标,然后调整自定义下的设置。
const materialIcon = CardService.newMaterialIcon().setName('search').setFill(true);
参数
名称 | 类型 | 说明 |
---|---|---|
fill | Boolean | 图标是否已填充。 |
返回
MaterialIcon
- 此对象,用于链式调用。
setGrade(grade)
Weight 和 Grade 会影响符号的粗细。调整 Grade 比调整 Weight 更精细,对符号大小的影响较小。从 {-25, 0, 200} 中进行选择。如果不存在,则默认值为 0。如果指定任何其他值,则使用默认值。
如需预览不同的图标设置,请前往 Google 字体图标,然后在 Customize 下调整设置。
const materialIcon = CardService.newMaterialIcon().setName('search').setGrade(200);
参数
名称 | 类型 | 说明 |
---|---|---|
grade | Integer | 图标的等级。 |
返回
MaterialIcon
- 此对象,用于链式调用。
setName(name)
设置图标的名称。必填。
Google 字体图标中定义的图标名称,例如 check_box
。
系统会舍弃所有无效名称并将其替换为空字符串,这会导致图标无法呈现。
const materialIcon = CardService.newMaterialIcon().setName('search');
参数
名称 | 类型 | 说明 |
---|---|---|
name | String | 图标的名称。 |
返回
MaterialIcon
- 此对象,用于链式调用。
setWeight(weight)
图标的描边粗细。请从 {100, 200, 300, 400, 500, 600, 700} 中进行选择。如果不存在,默认值为 400。如果指定任何其他值,则系统会使用默认值。
如需预览不同的图标设置,请前往 Google 字体图标,然后调整自定义下的设置。
const materialIcon = CardService.newMaterialIcon().setName('search').setWeight(700);
参数
名称 | 类型 | 说明 |
---|---|---|
weight | Integer | 图标的描边粗细。 |
返回
MaterialIcon
- 此对象,用于链式调用。