Integrazione risorse lato client

La classe Localizer in TypeScript è utilizzata per gestire le risorse localizzate nelle applicazioni frontend.

Questa soluzione permette di caricare e visualizzare testi localizzati in base alla cultura e al contesto specificati, garantendo un'esperienza utente coerente in ambienti multilingue. La classe Localizer condivide alcune logiche con la sua controparte server-side, ma è progettata specificamente per l'uso nel contesto client-side.

Inizializzazione della classe Localizer

Per inizializzare Localizer, è necessario caricare le risorse localizzate specificando la cultura predefinita e i contesti da recuperare. Un contesto rappresenta una raccolta di risorse che possono essere usate in una parte specifica dell'applicazione, come le risorse per la gestione dell'account o per la sezione newsletter.

import Localizer from "@Scripts/Common/Localizer";

export default class BasePage {
   public static async init() {
       await Localizer.init({
           defaultCulture: "en-US",
           resourceContexts: ["App", "Account", "Newsletter"]
       });
   }
}

Parametri di configurazione:

• defaultCulture: la cultura predefinita utilizzata per recuperare le risorse (ad esempio "en-US")
• resourceContexts: un array di contesti da caricare (ad esempio ["App", "Account", "Newsletter"])

Recupero delle risorse

Una volta inizializzato, Localizer permette di recuperare le risorse attraverso il metodo get fornendo la chiave della risorsa localizzata.

localizer.get("Account.Common.EmailOrUserName");

Questo comando restituirà il testo localizzato corrispondente alla chiave "Account.Common.EmailOrUserName".

Interpolazione di parametri

È possibile utilizzare l'interpolazione per inserire parametri dinamici all'interno del testo localizzato. Ad esempio:

localizer.getByCulture("Account.Common.EmailOrUserName", "en-US");

Questo restituirà la risorsa localizzata per la cultura indicata (in questo caso, "en-US").