Helpers & URL access

Access to form values and URL parameters — typed helpers and whitelisted access.

Live demo

Active route: /formulaires/helpers/— · from_url("search"): — · cleaned_string("search"): —

Test by modifying the URL:

/helpers/rust /helpers/rust?search=framework +is_admin=true (ignored — not in whitelist)

Cleaned Helpers — Whitelisted (POST > Path > Query)

// All methods return Option<T> (None if unknown or empty)
form.cleaned_string("username")   // -> Option<String>
form.cleaned_i32("age")         // -> Option<i32>
form.cleaned_f64("price")       // -> Option<f64>
form.cleaned_bool("active")      // -> Option<bool>
form.cleaned_uuid("ref")        // -> Option<Uuid>

// Handling default values:
let user = form.cleaned_string("user").unwrap_or_default(); // String
let age  = form.cleaned_i32("age").unwrap_or(18);           // i32

clear() — clear the form after processing

// Re-render empty form after success (without redirect)
if form.is_valid().await {
    let path = form.cleaned_string("image"); // 1. read before clear
    // save...
    form.clear();                               // 2. clear
    context_update!(request => { "upload_form" => &form });
    return request.render(template);            // 3. empty form displayed
}

// With redirect (PRG): clear() unnecessary
// the new GET request creates a fresh instance automatically

Date / time helpers

form.get_naive_date("birthday")
form.get_naive_time("meeting")
form.get_naive_datetime("event_start")
form.get_datetime_utc("created_at")

// Option variants
form.get_option_naive_date("birthday")
form.get_option_naive_datetime("event_start")
form.get_option_datetime_utc("created_at")

Raw URL parameter access — from Request

// Declared route: "/article/{id}"
let id   = request.path_param("id");   // Option<&str>

// Query string: /article/42?page=2
let page = request.from_url("page");  // Option<&str>

cleaned_*() — whitelisted, typed, all sources

// Priority: POST → path param → query param
// None if field is not declared in the form or is empty

form.cleaned_string("search")    // Option<String>
form.cleaned_i32("page")        // Option<i32>
form.cleaned_i64("id")          // Option<i64>
form.cleaned_f64("price")       // Option<f64>  (handles , → .)
form.cleaned_bool("active")     // Option<bool>
form.cleaned_uuid("ref")       // Option<Uuid>
form.cleaned_string("is_admin") // None — unknown field

Real example — GET search /blog/list?search=rust

// views.rs — filter articles according to query string
pub async fn blog_list(
    mut request: Request,
) -> AppResult<Response> {
    let form: SearchDemoForm = request.form();
    let search = form.cleaned_string("search");

    let mut query = BlogEntity::find();
    if let Some(ref term) = search {
        query = query.filter(
            Condition::any()
                .add(Column::Title.contains(term))
                .add(Column::Summary.contains(term)),
        );
    }
    // ...
}

// Real example: user search /view-user?username=alice
let username = form.cleaned_string("username").unwrap_or_default();

Doc FR Doc EN ← Forms