Routes and Responses
Creating routes is totally up to the framework you’re using for building your application, of course. However, we provide some facilities. For instance, you can render a simple page both ways:
use inertia_rust::{Inertia, InertiaFacade, InertiaService};
use actix_web::{app, get, Responder, HttpRequest};
// this
App::new().inertia_route("/", "Index");
// is the same as this
#[get("/")]
async fn index(req: HttpRequest) -> impl Responder {
Inertia::render(&req, "Index".into()).await
}
App::new().service(index);Redirects
If you want to redirect to another page, it’s enough to return your framework Redirect response. However, when
redirecting to an external site, make sure to use Inertia::location method. It’ll defer the redirect to the
browser:
use inertia_rust::{Inertia, InertiaFacade};
use actix_web::{get, Responder, HttpRequest};
#[get("/")]
async fn index(req: HttpRequest) -> impl Responder {
Inertia::location(&req, "https://inertiajs.com")
}To redirect to the previous page (a.k.a redirect back), use the back facade method:
use inertia_rust::{Inertia, InertiaFacade};
use actix_web::{get, Responder, HttpRequest};
#[get("/")]
async fn index(req: HttpRequest) -> impl Responder {
Inertia::back(&req)
}If you’ve configured your Inertia Temporary Session middleware, it will use the previous visited page with
more accuracy. Otherwise, it’ll look for a referer header. In last case, it will redirect to /.
Redirecting back with props is a little bit of advanced. Refer to Redirecting Back With Errors for an detailed explanation.
Responses
Calling the facade render method render a page (be it ReactJs, Svelte or Vue.js):
use inertia_rust::{Inertia, InertiaFacade};
use actix_web::{get, Responder, HttpRequest};
#[get("/users")]
async fn index(req: HttpRequest) -> impl Responder {
Inertia::render(&req, "Users/Index".into()).await
}"Users/Index" is a Component — which is just a meaningful struct containing the name of the jsx, vue or
svelte component to be rendered. Naturally, you must have configured your www/app.ts file to find this
page component (again, remember to check Inertia.js documentation).
For example, it could be:
import { Head } from "@inertiajs/react";
type User = {
name: string;
email: string;
}
type UsersPageProps = {
users: User[];
}
export default function UsersPage({ user }: UsersPageProps) {
return (
<>
<Head title="Users" />
<div>
<h1>Users</h1>
{users.map(user => (
<div>
<span><strong>Name: </strong>{user.name}</span>
<span><strong>E-mail: </strong>{user.email}</span>
</div>
))}
</div>
</>
)
}
You’ve noticed that this page has a user property. Actually, Inertia Rust is the one who will provide
this property! We didn’t provide any props to the page, though. We’ll fix this in the next chapter, where
props are discussed.