Class CardBuilder

CardBuilder

Card 对象的构建器。

方法

方法	返回类型	简介
addCardAction(cardAction)	CardBuilder	向此卡片添加 CardAction。
addSection(section)	CardBuilder	向此卡片添加部分。
build()	Card	构建当前卡片并对其进行验证。
setDisplayStyle(displayStyle)	CardBuilder	设置此卡片的显示样式。
setFixedFooter(fixedFooter)	CardBuilder	为此卡片设置固定页脚。
setHeader(cardHeader)	CardBuilder	设置此卡片的标题。
setName(name)	CardBuilder	设置此卡片的名称。
setPeekCardHeader(peekCardHeader)	CardBuilder	设置预览卡片标题。

详细文档

addCardAction(cardAction)

向此卡片添加 CardAction。

参数

名称	类型	说明
cardAction	CardAction	要使用的 CardAction。

返回

CardBuilder - 此对象，用于链式调用。

---

addSection(section)

向此卡片添加部分。您无法向卡片添加超过 100 个部分。

参数

名称	类型	说明
section	CardSection	要使用的 CardSection。

返回

CardBuilder - 此对象，用于链式调用。

---

build()

构建当前卡片并对其进行验证。

返回

Card - 已验证的卡。

抛出

Error - 如果构建的卡片无效。

---

setDisplayStyle(displayStyle)

设置此卡片的显示样式。

如果将显示样式设置为 DisplayStyle.REPLACE，系统会通过替换卡片堆叠中顶部卡片的视图来显示卡片。

如果将显示样式设置为 DisplayStyle.PEEK，则卡片的标题会显示在侧边栏底部，部分覆盖堆叠的当前顶部卡片。点击标题会将卡片弹出到卡片堆叠中。如果卡片没有标题，系统会改用生成的标题。

DisplayStyle 仅适用于从内容相关触发器函数返回的卡片。

参数

名称	类型	说明
displayStyle	DisplayStyle	要设置的 DisplayStyle。

返回

CardBuilder - 此对象，用于链式调用。

---

setFixedFooter(fixedFooter)

为此卡片设置固定页脚。

参数

名称	类型	说明
fixedFooter	FixedFooter	要使用的 FixedFooter。

返回

CardBuilder - 此对象，用于链式调用。

---

setHeader(cardHeader)

设置此卡片的标题。

参数

名称	类型	说明
cardHeader	CardHeader	要使用的 CardHeader。

返回

CardBuilder - 此对象，用于链式调用。

---

setName(name)

设置此卡片的名称。该名称可用于导航。

参数

名称	类型	说明
name	String	名称。

返回

CardBuilder - 此对象，用于链式调用。

---

setPeekCardHeader(peekCardHeader)

设置预览卡片标题。

系统会在从情境触发器函数返回的第一张卡片上设置预览卡片。它用作描述性占位符微件，以便用户从首页堆栈导航到内容相关堆栈。

参数

名称	类型	说明
peekCardHeader	CardHeader	要设置的 CardHeader。

返回

CardBuilder - 此对象，用于链式调用。