Router

Routers can be used to match against url paths and extract parameters. A router is an ElementFactory and can be passed directly to the app.

Adding Routes

Routes can be added with add_route supplying the pattern and the element factory for this route. Alternatively routes can be added using decorators.

add_router merges the routes of another Router instance, which is useful when building feature modules.

from rxxxt import Router, El, App
import uvicorn

router = Router()

child = Router()
child.add_route("/child", lambda: El.div(content=["child"]))
router.add_router(child)

def hello_factory():
  return El.div(content=["hello"])

router.add_route("/hello", hello_factory)

@router.route("/world")
def world_factory():
  return El.div(content=["world"])

app = App(router)
uvicorn.run(app)

Route Patterns

Routing uses match_path.

Accessing Parameters

To access the route parameters the router_params class field can be used inside components.

from rxxxt import Router, router_params, Component, event_handler, El, Element, App
import uvicorn

class ShowPath(Component):
  params = router_params()

  @event_handler()
  def nav_hello(self): self.context.navigate("/hello")

  @event_handler()
  def nav_world(self): self.context.navigate("/world")

  def render(self) -> Element:
    return El.div(content=[
      El.div(content=[f"Word: {self.params.get('word', '-')}"]),
      El.button(onclick=self.nav_hello, content=["nav 'hello'"]),
      El.button(onclick=self.nav_world, content=["nav 'world'"]),
    ])

router = Router()
router.add_route("/{word}", ShowPath)

app = App(router)
uvicorn.run(app)