FAQs

• How to get LanguageIdentifier?
• Custom cookie attributes are invalid
• Why examples don't use <For/> component?
• How to manage translations on server actions
• How to get values of leptos_fluent! macro at runtime?

How to get LanguageIdentifier?

use fluent_templates::LanguageIdentifier;

Custom cookie attributes are invalid

Use an expression to set the cookie attributes and will not be validated.

let attrs = "SameSite=Strict; MyCustomAttr=MyCustomValue;";
leptos_fluent! {
    cookie_attrs: attrs,
    // ...
};

Why examples don't use <For/> component?

In any case, the <For/> component is safe on CSR contexts and leptos_fluent::Language implement Hash and Eq traits to be able to be passed directly to keys properties trigerring reactivity depending on the current active language.

use leptos_fluent::{i18n, Language};

leptos::logging::warn!("[WARNING]: Not secure on SSR");
view! {
    <p>{move_tr!("select-a-language")}</p>
    <For
        each=move || i18n().languages
        key=|lang| *lang
        children=move |lang| render_language(lang)
    />
}

fn render_language(lang: &'static Language) -> impl IntoView { ... }

How to manage translations on server actions

The translations reside on the client side, so the I18n can not be accessed as context on server actions. Pass the translations as values if the bandwidth is not a problem or use your own statics on server side.

use leptos::prelude::*;
use leptos_fluent::{tr, Language, I18n};

/// Server action showing client-side translated message on console
#[server(ShowHelloWorld, "/api")]
pub async fn show_hello_world(
    translated_hello_world: String,
    language: String,
) -> Result<(), ServerFnError> {
    println!("{translated_hello_world} ({language})");
    Ok(())
}

fn render_language(lang: &'static Language) -> impl IntoView {
    let i18n = expect_context::<I18n>();

    // Call on click to server action with a client-side translated
    // "hello-world" message
    let on_click = move |_| {
        i18n.language.set(lang);
        spawn_local(async {
            _ = show_hello_world(
                tr!(i18n, "hello-world"),
                lang.name.to_string(),
            ).await;
        });
    };

    view! {
        <div>
            <label for=lang>{lang.name}</label>
            <input
                id=lang
                name="language"
                value=lang
                checked=i18n.language.get() == lang
                on:click=on_click
                type="radio"
            />
        </div>
    }
}

How to get values of leptos_fluent! macro at runtime?

Use provide_meta_context at the macro initialization and get them with the method I18n::meta:

leptos_fluent! {
    // ...
    provide_meta_context: true,
};

// ... later
let i18n = expect_context::<I18n>();
println!("Macro parameters: {:?}", i18n.meta().unwrap());