Navigation API
Navigation API 的 NavigationDestination 接口表示当前导航中要导航到的目标。
它可通过 NavigateEvent.destination 属性访问。
实例属性
- NavigationDestination.id
- : 如果 NavigateEvent.navigationType 为
traverse,则返回目标 NavigationHistoryEntry 的 NavigationHistoryEntry.id 值,否则返回空字符串。
- : 如果 NavigateEvent.navigationType 为
- NavigationDestination.index
- : 如果 NavigateEvent.navigationType 为
traverse,则返回目标 NavigationHistoryEntry 的 NavigationHistoryEntry.index 值,否则返回-1。
- : 如果 NavigateEvent.navigationType 为
- NavigationDestination.key
- : 如果 NavigateEvent.navigationType 为
traverse,则返回目标 NavigationHistoryEntry 的 NavigationHistoryEntry.key 值,否则返回空字符串。
- : 如果 NavigateEvent.navigationType 为
- NavigationDestination.sameDocument
- : 如果导航到与当前 Document 值相同的
document,则返回true,否则返回false。
- : 如果导航到与当前 Document 值相同的
- NavigationDestination.url
- : 返回导航到的 URL 地址。
实例方法
- NavigationDestination.getState
- : 返回与目标 NavigationHistoryEntry 或导航操作(例如 Navigation.navigate())相关的可用状态的克隆。
示例
navigation.addEventListener("navigate", (event) => {
// 如果此导航不应被拦截,则提前退出,例如,如果导航是跨源的,或者是下载请求
if (shouldNotIntercept(event)) {
return;
}
// 返回由 NavigationDestination.url 值构造的 URL() 对象
const url = new URL(event.destination.url);
if (url.pathname.startsWith("/articles/")) {
event.intercept({
async handler() {
// URL 已更改,因此在获取新内容时显示占位符,例如旋转图标或加载页面
renderArticlePagePlaceholder();
// 获取新内容并在准备就绪时显示
const articleContent = await getArticleContent(url.pathname);
renderArticlePage(articleContent);
},
});
}
});
规范
浏览器兼容性
参见
- 现代客户端路由:导航 API
- 导航 API 说明
- Domenic Denicola 的导航 API 在线演示
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
