語法
js
traverseTo(key)
traverseTo(key, options)
引數
key-
要導航到的
NavigationHistoryEntry的key。 options可選-
一個包含以下屬性的選項物件
info可選-
要傳遞給
navigate事件的開發者定義的資訊，可在NavigateEvent.info中訪問。這可以是任何資料型別。例如，您可能希望根據內容的導航方式（左滑、右滑或主頁）以不同的動畫顯示新導航的內容。可以將指示使用哪種動畫的字串作為info傳遞。
返回值
具有以下屬性的物件：
committed-
一個
Promise，當可見 URL 已更改且已建立新的NavigationHistoryEntry時，它將fulfilled。 finished-
一個
Promise，當intercept()處理程式返回的所有 Promise 都 fulfilled 時，它將 fulfilled。這相當於NavigationTransition.finishedPromise fulfilled，當navigatesuccess事件觸發時。
如果導航因某種原因失敗，則這兩個 Promise 中的任何一個都會 rejected。
異常
InvalidStateErrorDOMException-
如果
Navigation.currentEntry的NavigationHistoryEntry.index值為 -1，意味著當前的Document尚未啟用，或者導航歷史列表不包含具有指定 key 的NavigationHistoryEntry，或者當前的Document正在解除安裝，則會丟擲此異常。
示例
設定主頁按鈕
js
function initHomeBtn() {
// Get the key of the first loaded entry
// so the user can always go back to this view.
const { key } = navigation.currentEntry;
backToHomeButton.onclick = () => {
navigation.traverseTo(key);
};
}
// Intercept navigate events, such as link clicks, and
// replace them with single-page navigations
navigation.addEventListener("navigate", (event) => {
event.intercept({
async handler() {
// Navigate to a different view,
// but the "home" button will always work.
},
});
});
規範
| 規範 |
|---|
| HTML # dom-navigation-traverseto-dev |
瀏覽器相容性
載入中…