visionmedia/page.js
Page.js
page.js is a client-side JavaScript router for single-page applications that maps URL patterns to executable functions. It functions as a navigation engine and browser history manager, implementing a middleware-based path-mapping system similar to the Express web framework.
The library distinguishes itself through an Express-style router model, utilizing a middleware callback chain and a shared context object to pass data between navigation handlers. It supports advanced window management, allowing for multiple router instances to handle navigation independently across different windows or embedded iframes.
The routing surface covers regex-based path matching, URL parameter extraction, and programmatic navigation. It includes support for hashbang URLs, route redirection, and lifecycle hooks such as exit callbacks for state preservation. Global route middleware provides a mechanism to execute universal logic across all transitions.
Configuration options allow for the definition of base path prefixes and the toggling of browser history binding to control how the application intercepts click events.
Features
- Route-to-Callback Mapping - Maps specific URL paths or patterns to executable functions that run whenever the browser matches that path.
- Client-side Routing - Provides a framework for managing navigation and view transitions in single-page applications.
- Route Pattern Matching - Uses regular expression patterns to map URL paths to specific executable handler functions.
- Route Middleware - Registers global callbacks that execute on every route change to perform universal tasks.
- Context Sharing - Utilizes a shared context object to pass data and state between different navigation middleware handlers.
- Single Page Applications - Manages dynamic content updates and browser history transitions for single-page application architectures.
- View-to-URL Mapping - Associates URL patterns with executable functions to update application state during client-side navigation.
- Browser History Management - Provides utilities to synchronize application state with browser history and fragment identifiers.
- Navigation Interception - Intercepts browser navigation events and click actions to update the UI without reloading the page.
- Navigation Middleware - Implements middleware pipelines to execute global logic and authentication checks during navigation transitions.
- Client-Side Routers - Functions as a client-side routing library that maps URL patterns to executable functions in the browser.
- Express-Style Routers - Implements a routing system based on the middleware callback chain and path-matching patterns of the Express framework.
- Middleware Chains - Implements an Express-style middleware chain to process navigation requests in sequence.
- URL Parameter Extraction - Extracts named or indexed variables from URL paths using regular expressions or wildcards to drive application logic.
- Browser History State Caching - Saves context data to browser history to preserve page content and resources when the user navigates backward.
- Router Instance Binding - Allows binding independent routing logic to different window or iframe objects to manage separate navigation streams.
- Iframe Routing Management - Enables independent URL mapping and navigation control within embedded windows or iframes.
- Navigation - Executes specific callbacks upon navigating away from a path to perform cleanup or preserve application state.
- Context Object Passing - Implements a shared context object that is passed through the route execution chain to maintain state between handlers.
- Iframe - Manages navigation and URL mapping within a specific window or iframe independently from the primary browser window.
- Multi-Window Router Instances - Creates separate router instances to handle navigation independently across different windows or embedded iframes.
- Hash-Based Routing - Supports client-side navigation using URL hash fragments to switch views without triggering full page reloads.
- Programmatic Navigation - Provides APIs to trigger route changes programmatically via code.
- Hashbang Routing - Supports routing via fragment identifiers starting with #! to maintain navigation while preserving clean URL structures.
- Redirection Rules - Implements rules to redirect users from one URL path to another with optional history cleanup.
- Routing - Small client-side router inspired by Express.
- Routing Libraries - Micro client-side router inspired by Express.
- 路由和链接(Routing And URLs) - Listed in the “路由和链接(Routing And URLs)” section of the Awesome Frontend awesome list.
