Navigation API
Navigation API 的 NavigationCurrentEntryChangeEvent 接口是 Navigation/currententrychange_event 事件的事件对象,该事件在 Navigation.currentEntry 发生更改时触发。
此事件将在以下情况下触发:同一文档导航(例如 Navigation.back 或 Navigation.traverseTo)、替换(即 Navigation.navigate 调用,其中 history 设置为 replace),或其他更改条目状态的调用(例如 Navigation.updateCurrentEntry,或History API 的 History.replaceState())。
此事件在导航提交后触发,这意味着可见 URL 已更改,并且已发生 NavigationHistoryEntry 更新。它对于从使用较旧的 API 特性(如 Window/hashchange_event 或 Window/popstate_event 事件)迁移非常有用。
构造函数
- NavigationCurrentEntryChangeEvent.NavigationCurrentEntryChangeEvent
- : 创建一个新的
NavigationCurrentEntryChangeEvent对象实例。
- : 创建一个新的
实例属性
从其父级 Event 继承属性。
- NavigationCurrentEntryChangeEvent.from
- : 返回导航来源的 NavigationHistoryEntry。
- NavigationCurrentEntryChangeEvent.navigationType
- : 返回导致改变的导航的类型。
示例
导航数据上报:
navigation.addEventListener("currententrychange", () => {
const data = navigation.currentEntry.getState();
submitAnalyticsData(data.analytics);
});
设置每个条目事件:
navigation.addEventListener("currententrychange", () => {
navigation.currentEntry.addEventListener("dispose", genericDisposeHandler);
});
规范
浏览器兼容性
参见
- 现代客户端路由:导航 API
- 导航 API 说明
- Domenic Denicola 的导航 API 在线演示
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
