Class Navigation
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
內容詳盡的說明文件
popCard()
從導覽資料堆疊中彈出資訊卡。可與其他資訊卡導覽動作連結。
回攻員
Navigation：這個物件用於鏈結。
popToNamedCard(cardName)
根據指定卡片的名稱，彈出指定卡片。可與其他資訊卡導覽動作連結。
參數
| 名稱 | 類型 | 說明 |
cardName | String | 要前往的資訊卡名稱。 |
回攻員
Navigation：這個物件用於鏈結。
popToRoot()
將卡片堆疊彈出至根卡片。可與其他資訊卡導覽動作連結。
回攻員
Navigation：這個物件用於鏈結。
printJson()
列印此物件的 JSON 表示法。這項設定僅供偵錯。
回攻員
String
pushCard(card)
將指定的牌推送至堆疊。可與其他資訊卡導覽動作連結。
參數
回攻員
Navigation：這個物件用於鏈結。
updateCard(card)
是否會原地取代目前的卡片。可與其他資訊卡導覽動作連結。
參數
| 名稱 | 類型 | 說明 |
card | Card | 用來取代目前卡片的卡片。 |
回攻員
Navigation：這個物件用於鏈結。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：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."]]
