https://github.com/ctron/yew-nested-router

A router for Yew supporting nesting
https://github.com/ctron/yew-nested-router

frontend router rust yew

Last synced: about 2 months ago
JSON representation

A router for Yew supporting nesting

• Host: GitHub
• URL: https://github.com/ctron/yew-nested-router
• Owner: ctron
• License: apache-2.0
• Created: 2022-12-02T16:24:40.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-19T06:22:03.000Z (5 months ago)
• Last Synced: 2024-06-22T05:04:58.549Z (3 months ago)
• Topics: frontend, router, rust, yew
• Language: Rust
• Homepage:
• Size: 104 KB
• Stars: 6
• Watchers: 2
• Forks: 5
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-yew - yew-nested-router - A router that supported nesting, with Yew 0.20. (Crates / Utils)

README

        
# Yew Nested Router

[![crates.io](https://img.shields.io/crates/v/yew-nested-router.svg)](https://crates.io/crates/yew-nested-router)

[![docs.rs](https://docs.rs/yew-nested-router/badge.svg)](https://docs.rs/yew-nested-router)

A router for Yew that supports nesting.

## Example

In a nutshell, you define a main router entry point (`>`) where you can switch the rendering (`>`).

You can then translate down to the next layer (`Scope
`), so that you can switcher rendering again (`Switch`).

See a complete example: [examples/yew-nested-router-example](examples/yew-nested-router-example), which

you can run using:

```shell

trunk serve examples/yew-nested-router-example/index.html

```

## Rationale

This project was born out of [the need for a nesting router](https://github.com/yewstack/yew/issues/1853) using Yew.

This used to work in past releases, but starting  with 0.19, the router implementation was swapped out for a new one

which didn't properly support nesting. It still  was possible to [backport](https://github.com/ctron/yew-router) the

old router to Yew 0.19, using the Yew Agent project.

However, in Yew Agent 0.2, which is required by Yew 0.20, the "context" agent was removed. So it was no longer possible

to backport the old router implementation.

This is a new, from scratch, implementation of a router for Yew. It supports nesting, and using Rust types for routes.

## Goals and opinions

This is not a drop-in replacement for the old Yew router. This section briefly describes which choices this

implementation made:

* The router supports a nested structured, where the child elements don't need to be aware of their parents.

  This is required in many cases, where one want to re-use lower level routes on different top level routes.

* Routes are not defined by regular expressions or other pattern matching, but by simply splitting the path of a URL

  using the forward slash (`/`) into segments.

* The implementation should try to help avoiding mistakes by using Rust's type system. But it won't fully guard against

  all mistakes which can be made.