16 breaking releases

0.17.0 Nov 25, 2022
0.16.0 Dec 11, 2021
0.15.0 May 15, 2021
0.14.0 Jun 30, 2020
0.3.0 Jul 24, 2019

#81 in Web programming

Download history 3063/week @ 2023-02-05 3892/week @ 2023-02-12 3419/week @ 2023-02-19 3362/week @ 2023-02-26 4068/week @ 2023-03-05 3198/week @ 2023-03-12 4065/week @ 2023-03-19 3855/week @ 2023-03-26 3767/week @ 2023-04-02 3645/week @ 2023-04-09 3276/week @ 2023-04-16 3277/week @ 2023-04-23 3781/week @ 2023-04-30 5307/week @ 2023-05-07 5773/week @ 2023-05-14 3907/week @ 2023-05-21

19,014 downloads per month
Used in 16 crates (15 directly)

MIT/Apache

585KB
14K SLoC

yew-router

A routing library for the Yew frontend framework.

Read on how to use it on yew.rs


lib.rs:

Provides routing faculties using the browser history API to build Single Page Applications (SPAs) using Yew web framework.

Usage

use yew::functional::*;
use yew::prelude::*;
use yew_router::prelude::*;

#[derive(Debug, Clone, Copy, PartialEq, Routable)]
enum Route {
    #[at("/")]
    Home,
    #[at("/secure")]
    Secure,
    #[not_found]
    #[at("/404")]
    NotFound,
}

#[function_component(Secure)]
fn secure() -> Html {
    let navigator = use_navigator().unwrap();

    let onclick_callback = Callback::from(move |_| navigator.push(&Route::Home));
    html! {
        <div>
            <h1>{ "Secure" }</h1>
            <button onclick={onclick_callback}>{ "Go Home" }</button>
        </div>
    }
}

#[function_component(Main)]
fn app() -> Html {
    html! {
        <BrowserRouter>
            <Switch<Route> render={switch} />
        </BrowserRouter>
    }
}

fn switch(routes: Route) -> Html {
    match routes {
        Route::Home => html! { <h1>{ "Home" }</h1> },
        Route::Secure => html! {
            <Secure />
        },
        Route::NotFound => html! { <h1>{ "404" }</h1> },
    }
}

Internals

The router registers itself as a context provider and makes location information and navigator available via [hooks] or RouterScopeExt.

State

The Location API has a way to access / store state associated with session history. Please consult location.state() for detailed usage. A module that provides universal session history and location information. Prelude module to be imported when working with yew-router.

This module re-exports the frequently used types from the crate.

Dependencies

~11–18MB
~309K SLoC