21 releases

new 0.6.0-rc.0 Dec 3, 2024
0.6.0-alpha.5 Nov 16, 2024
0.6.0-alpha.3 Oct 14, 2024
0.5.6 Jul 18, 2024
0.2.2 Mar 10, 2022

#681 in Web programming

Download history 2432/week @ 2024-08-14 2255/week @ 2024-08-21 2571/week @ 2024-08-28 2191/week @ 2024-09-04 2611/week @ 2024-09-11 2448/week @ 2024-09-18 2735/week @ 2024-09-25 2131/week @ 2024-10-02 2267/week @ 2024-10-09 2814/week @ 2024-10-16 2854/week @ 2024-10-23 2377/week @ 2024-10-30 1794/week @ 2024-11-06 2082/week @ 2024-11-13 2142/week @ 2024-11-20 2257/week @ 2024-11-27

8,675 downloads per month
Used in 24 crates (6 directly)

MIT/Apache

125KB
1.5K SLoC

Dioxus Router

Crates.io MIT licensed Build Status Discord chat

Website | Guides | API Docs | Chat

Overview

Dioxus Router is a first-party Router for all your Dioxus Apps. It provides an interface similar to React Router, but takes advantage of types for more expressiveness.

use dioxus::prelude::*;
use dioxus_router::prelude::*;
use std::str::FromStr;

#[rustfmt::skip]
#[derive(Clone, Debug, PartialEq, Routable)]
enum Route {
    #[nest("/blog")]
        #[layout(Blog)]
            #[route("/")]
            BlogList {},

            #[route("/:blog_id")]
            BlogPost { blog_id: usize },
        #[end_layout]
    #[end_nest]
    #[route("/")]
    Index {},
}

#[component]
fn App() -> Element {
    rsx! {
        Router::<Route> { }
    }
}

#[component]
fn Index() -> Element {
    rsx! {
        h1 { "Index" }
        Link {
            to: Route::BlogList {},
            "Go to the blog"
        }
    }
}

#[component]
fn Blog() -> Element {
    rsx! {
        h1 { "Blog" }
        Outlet::<Route> { }
    }
}

#[component]
fn BlogList() -> Element {
    rsx! {
        h2 { "List of blog posts" }
        Link {
            to: Route::BlogPost { blog_id: 0 },
            "Blog post 1"
        }
        Link {
            to: Route::BlogPost { blog_id: 1 },
            "Blog post 2"
        }
    }
}

#[component]
fn BlogPost(blog_id: usize) -> Element {
    rsx! {
        h2 { "Blog Post" }
    }
}

You need to enable the right features for the platform you're targeting since these are not determined automatically!

Contributing

  • Report issues on our issue tracker.
  • Join the discord and ask questions!

License

This project is licensed under the MIT license.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Dioxus by you shall be licensed as MIT without any additional terms or conditions.

Dependencies

~5–10MB
~106K SLoC