Passa al contenuto principale

Webround Runtime Utilities

L'oggetto wr espone un set di utility core progettate per gestire la localizzazione e la navigazione all'interno del runtime di Webround in modo coerente. Questi strumenti garantiscono che l'applicazione rimanga sincronizzata con la lingua preferita dell'utente e con le configurazioni del sito.

Proprietà di Localizzazione​

Il runtime espone lo stato attuale della localizzazione attraverso due proprietà principali:

  • wr.languages: Un array di codici ISO (string[]) che rappresenta le lingue abilitate per il sito. Queste sono configurabili tramite la sidebar sinistra dell'editor di Webround.
  • wr.locale: Una stringa che identifica il locale attualmente attivo (es. "en", "it").

Funzioni Utility​

changeLanguage(locale: string): void​

Aggiorna lo stato globale dell'applicazione verso una nuova lingua. La funzione accetta un codice ISO e switcha il contesto del runtime, aggiornando automaticamente tutti i componenti e i contenuti localizzati tramite l'evento wr-change-language.

Esempio:

wr.utils.changeLanguage('it');

generateHref(path: string): string​

Una funzione pura utilizzata per generare URL interni. Calcola il percorso corretto anteponendo automaticamente il locale attivo al path fornito, garantendo che i link puntino alla versione localizzata corretta della pagina.

Esempio:

// Se il locale attuale è 'en'
const link = wr.utils.generateHref('/contact'); 
// Restituisce: "/en/contact"

Esegue una navigazione immediata lato client verso il percorso specificato. Questa funzione è "locale-aware": gestisce internamente la risoluzione del percorso basandosi sul locale attuale (tramite l'evento wr-navigate), assicurando che l'utente rimanga nel contesto linguistico corretto.

Esempio:

wr.utils.navigate('/checkout');