molefrog/wouter
Wouter
Wouter is a minimalist client-side routing library for React and Preact. It uses a hook-based system to map URL paths to components, managing navigation and URL state without requiring a mandatory provider.
The library is designed for cross-ecosystem compatibility between React and Preact and supports server-side rendering by accepting initial paths and search strings during markup generation. It includes a URL parameter manager for extracting dynamic path segments and query strings from the browser address bar.
Capabilities include hierarchical nested routing, programmatic navigation management, and the ability to configure global base paths. It provides utilities for route pattern matching, automatic redirection, and navigation interception. For automated testing, the library includes a memory-based routing simulation to mock URL states.
Features
- View-to-URL Mapping - Uses a hook-based system to map URL paths to specific React or Preact components.
- Client-Side Navigation Management - Provides programmatic control over browser location and conditional content rendering based on the current URL state.
- Hook-Based Matching - Uses custom React hooks to determine which components to render by comparing the current URL against path patterns.
- Nested Routing - Supports hierarchical route structures where child components match paths relative to a parent routing context.
- Programmatic Navigation - Provides APIs for programmatically updating the browser location and tracking the current URL path.
- Hook-Based Implementations - Implements a routing system using custom hooks to manage URL state, path matching, and navigation transitions.
- Pattern-Matching Routers - Resolves request paths using string matching and regular expressions to trigger associated components.
- Route Parameter Accessors - Provides hooks and utilities to retrieve dynamic values from matched URL path segments.
- Dynamic Segment Extraction - Retrieves variable values from dynamic URL path segments to load specific data into components.
- Preact Routers - Provides a lightweight routing solution compatible with both React and Preact ecosystems.
- React Routers - Provides a minimalist routing solution specifically designed for the React and Preact component models.
- Regex Path Matchers - Converts route patterns with dynamic segments into regular expressions to extract parameters from the window location.
- URL State Mocking - Allows overriding the browser URL with a mock state for server-side rendering or automated testing environments.
- Navigation Guards - Implements hooks to intercept navigation transitions for performing validation or executing side effects.
- Search Parameters - Provides a standard interface for reading and updating URL query parameters in the address bar.
- Client-Side Navigation Components - Ships custom anchor elements that handle client-side navigation and provide active-state styling.
- Server-Side Rendering - Supports server-side rendering by accepting initial paths and search strings during the markup generation process.
- SSR-Compatible Routing - Supports server-side rendering by accepting initial paths and search strings during the initial render.
- URL State Management - Reads and updates search parameters in the browser address bar to maintain application state across page refreshes.
- Routers and URL Utils - Declarative routing for React and Preact.
- Routing Libraries - Tiny router with a React Router-like API.
