Referencia

ascua-router

Las siete funciones del router, con su firma.

ts
import { links, match, mountRoutes, navigate, path, query, stripQuery } from "ascua-router";

1,03 kB gzip. Depende de ascua. La guía está en Rutas.

path

ts
function path(): string;

La ruta actual, con su query: /pedidos?orden=fecha. Reactiva.

ts
function navigate(destino: string, options?: { replace?: boolean }): void;

Cambia de ruta sin recargar. Con replace, sustituye la entrada del historial en vez de apilar una nueva.

ts
function links(raiz?: Node, options?: { base?: string }): () => void;

Intercepta los clicks en <a href> internos dentro de raiz —el documento, por defecto—. Deja pasar los clicks con modificadores, el botón central, los enlaces con target, download o rel="external", los de otro origen y, con base, los que no cuelgan de ella. Devuelve cómo soltarlo.

mountRoutes

ts
interface Route {
  pattern?: string;
  view: (params: Params) => Node;
}

function mountRoutes(padre: Node, rutas: readonly Route[]): () => void;

Monta en padre la vista de la primera ruta que encaje. Una ruta sin pattern encaja siempre. Devuelve cómo soltarla.

match

ts
type Params = Record<string, string>;

function match(pattern: string, contra?: string): Params | null;

Los parámetros que captura pattern en contra —la ruta actual, por defecto—, o null si no encaja. :nombre captura un segmento y * el resto, en rest.

query

ts
function query(): URLSearchParams;

Lo que va tras ?, parseado. Reactiva.

stripQuery

ts
function stripQuery(valor: string): string;

El camino sin la query.