Class Navigation
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
导航
用于控制卡片导航的辅助对象。如需了解详情，请参阅卡片导航指南。
详细文档
popCard()
从导航堆栈中弹出卡片。可与其他卡片导航操作链接。
返回
Navigation - 此对象，用于链式调用。
popToNamedCard(cardName)
按卡片名称跳转到指定卡片。可与其他卡片导航操作链接。
参数
| 名称 | 类型 | 说明 |
cardName | String | 要导航到的卡片的名称。 |
返回
Navigation - 此对象，用于链式调用。
popToRoot()
将卡片堆叠弹出到根卡片。可与其他卡片导航操作链接。
返回
Navigation - 此对象，用于链式调用。
printJson()
输出此对象的 JSON 表示法。这仅用于调试。
返回
String
pushCard(card)
将给定卡片推送到堆栈。可与其他卡片导航操作链接。
参数
| 名称 | 类型 | 说明 |
card | Card | 要添加到堆叠中的卡片。 |
返回
Navigation - 此对象，用于链式调用。
updateCard(card)
对当前卡片进行原位替换。可与其他卡片导航操作链接。
参数
| 名称 | 类型 | 说明 |
card | Card | 用于替换当前卡片的卡片。 |
返回
Navigation - 此对象，用于链式调用。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003eThe Navigation object facilitates card navigation within Google Workspace add-ons, allowing developers to control the flow and presentation of user interfaces.\u003c/p\u003e\n"],["\u003cp\u003eIt offers methods like \u003ccode\u003epushCard()\u003c/code\u003e, \u003ccode\u003epopCard()\u003c/code\u003e, and \u003ccode\u003eupdateCard()\u003c/code\u003e to manage the card stack, enabling dynamic and interactive user experiences.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use \u003ccode\u003epopToNamedCard()\u003c/code\u003e or \u003ccode\u003epopToRoot()\u003c/code\u003e for direct navigation to specific cards within the stack, enhancing user control and flexibility.\u003c/p\u003e\n"],["\u003cp\u003eAll navigation methods are chainable, providing a streamlined and efficient way to sequence multiple actions and create complex navigation flows within the add-on.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eprintJson()\u003c/code\u003e method aids debugging by outputting the object's JSON representation, allowing developers to inspect its structure and state.\u003c/p\u003e\n"]]],[],null,["# Class Navigation\n\nNavigation\n\nA helper object that controls card navigation. See the [card navigation guide](/gmail/add-ons/how-tos/navigation) for more details. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------|-----------------|---------------------------------------------------|\n| [popCard()](#popCard()) | [Navigation](#) | Pops a card from the navigation stack. |\n| [popToNamedCard(cardName)](#popToNamedCard(String)) | [Navigation](#) | Pops to the specified card by its card name. |\n| [popToRoot()](#popToRoot()) | [Navigation](#) | Pops the card stack to the root card. |\n| [printJson()](#printJson()) | `String` | Prints the JSON representation of this object. |\n| [pushCard(card)](#pushCard(Card)) | [Navigation](#) | Pushes the given card onto the stack. |\n| [updateCard(card)](#updateCard(Card)) | [Navigation](#) | Does an in-place replacement of the current card. |\n\nDetailed documentation\n----------------------\n\n### `pop``Card()`\n\nPops a card from the navigation stack. Can be chained with other card navigation actions.\n\n#### Return\n\n\n[Navigation](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `pop``To``Named``Card(cardName)`\n\nPops to the specified card by its card name. Can be chained with other card navigation actions.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------|----------|--------------------------------------|\n| `card``Name` | `String` | The name of the card to navigate to. |\n\n#### Return\n\n\n[Navigation](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `pop``To``Root()`\n\nPops the card stack to the root card. Can be chained with other card navigation actions.\n\n#### Return\n\n\n[Navigation](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `print``Json()`\n\nPrints the JSON representation of this object. This is for debugging only.\n\n#### Return\n\n\n`String`\n\n*** ** * ** ***\n\n### `push``Card(card)`\n\nPushes the given card onto the stack. Can be chained with other card navigation actions.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|--------------------------------------------------|-----------------------------|\n| `card` | [Card](/apps-script/reference/card-service/card) | A card to add to the stack. |\n\n#### Return\n\n\n[Navigation](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `update``Card(card)`\n\nDoes an in-place replacement of the current card. Can be chained with other card navigation\nactions.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|--------------------------------------------------|------------------------------------------|\n| `card` | [Card](/apps-script/reference/card-service/card) | A card to replace the current card with. |\n\n#### Return\n\n\n[Navigation](#) --- This object, for chaining."]]
