Struct Renderer 

pub struct Renderer { /* private fields */ }

Axum extractor for rendering MiniJinja templates.

Renderer is extracted from a handler’s argument list and provides three render methods:

• html — renders a template and returns Html<String>.
• html_partial — renders the partial template when the request is an HTMX request, or the full page template otherwise.
• string — renders a template and returns String.

The handler’s context argument is merged with the middleware-populated TemplateContext; handler values override middleware values on conflict.

Requirements

• Engine must be registered in the crate::service::AppState registry.
• TemplateContextLayer must be installed as a middleware layer on the router.

Example

use modo::template::{Renderer, context};
use axum::response::Html;

async fn home(renderer: Renderer) -> modo::Result<Html<String>> {
    renderer.html("pages/home.html", context! { title => "Home" })
}

Implementations

impl Renderer

pub fn html(&self, template: &str, context: Value) -> Result<Html<String>>

Renders template with the given MiniJinja context merged with middleware context, and returns Html<String>.

Errors

Returns Error if the template is not found or rendering fails.

pub fn html_partial( &self, page: &str, partial: &str, context: Value, ) -> Result<Html<String>>

Renders partial if the request was issued by HTMX, otherwise renders page.

This is the primary method for HTMX-driven partial updates: the full page template is used for initial page loads, while partial is used for subsequent HTMX swaps.

Errors

Returns Error if the selected template is not found or rendering fails.

pub fn string(&self, template: &str, context: Value) -> Result<String>

Renders template with the given MiniJinja context merged with middleware context, and returns the raw String output.

Errors

Returns Error if the template is not found or rendering fails.

pub fn is_htmx(&self) -> bool

Returns true if the current request was issued by HTMX (HX-Request: true).

Trait Implementations

impl Clone for Renderer

fn clone(&self) -> Renderer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<S> FromRequestParts<S> for Renderer

where S: Send + Sync, AppState: FromRef<S>,

type Rejection = Error

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request_parts( parts: &mut Parts, state: &S, ) -> Result<Self, Self::Rejection>

Perform the extraction.