navigation
/
1.0.1-alpha.200
navigation 1.0.1-alpha.200
Install from the command line:
Learn more about npm packages
$ npm install @virtualstate/navigation@1.0.1-alpha.200
Install via package.json:
"@virtualstate/navigation": "1.0.1-alpha.200"
About this version
Native JavaScript navigation implementation
npm / yarn / GitHub
npm i --save @virtualstate/navigation
Or
yarn add @virtualstate/navigation
Then
import { Navigation } from "@virtualstate/navigation";
Skypack
const { Navigation } = await import("https://cdn.skypack.dev/@virtualstate/navigation");
Or
import { Navigation } from "https://cdn.skypack.dev/@virtualstate/navigation";
importmap
<script type="importmap">
{
"imports": {
"@virtualstate/navigation": "https://cdn.skypack.dev/@virtualstate/navigation"
}
}
</script>
<script type="module">
import { Navigation } from "@virtualstate/navigation"
</script>
See the MDN documentation for the Navigation API for in depth information on usage.
Examples
import { Navigation } from "@virtualstate/navigation";
const navigation = new Navigation();
// Set initial url
navigation.navigate("/");
navigation.navigate("/skipped");
// Use .finished to wait for the transition to complete
await navigation.navigate("/awaited").finished;
import { Navigation } from "@virtualstate/navigation";
const navigation = new Navigation();
navigation.addEventListener("navigate", async ({ destination, preventDefault }) => {
if (new URL(destination.url).pathname === "/disallow") {
preventDefault();
}
});
await navigation.navigate("/allowed").finished; // Resolves
await navigation.navigate("/disallow").finished; // Rejects
import { Navigation } from "@virtualstate/navigation";
import { loadPhotoIntoCache } from "./cache";
const navigation = new Navigation();
navigation.addEventListener("navigate", async ({ destination, intercept }) => {
intercept(loadPhotoIntoCache(destination.url));
});
You can match destination.url
using URLPattern
import {Navigation} from "@virtualstate/navigation";
import {URLPattern} from "urlpattern-polyfill";
const navigation = new Navigation();
navigation.addEventListener("navigate", async ({destination, intercept}) => {
const pattern = new URLPattern({ pathname: "/books/:id" });
const match = pattern.exec(destination.url);
if (match) {
intercept(transition());
}
async function transition() {
console.log("load book", match.pathname.groups.id)
}
});
navigation.navigate("/book/1");
import { Navigation } from "@virtualstate/navigation";
const navigation = new Navigation();
navigation.addEventListener("currententrychange", () => {
console.log({ updatedState: navigation.currentEntry?.getState() });
});
await navigation.updateCurrentEntry({
state: {
items: [
"first",
"second"
],
index: 0
}
}).finished;
await navigation.updateCurrentEntry({
state: {
...navigation.currentEntry.getState(),
index: 1
}
}).finished;
If a global instance of the navigation API is not available, this will provide one, integrated into the History API if available.
import "@virtualstate/navigation/polyfill";
await navigation.navigate("/").finished;
Details
- navigation
- virtualstate
- 9 months ago
- MIT
- 36 dependencies
Assets
- navigation-1.0.1-alpha.200.tgz
Download activity
- Total downloads 0
- Last 30 days 0
- Last week 0
- Today 0