Una cadena localitzada és una propietat de text que guarda un valor diferent per a cada idioma que el teu tenant admet. Fes-la servir per a tot allò que llegeix un usuari final i que hauria de canviar segons l'idioma de la interfície — el nom d'un producte, el títol d'un article, l'etiqueta d'una categoria.

És un tipus de propietat propi, que tries en dissenyar el model. Una cadena (String) normal guarda un sol valor i prou. Una cadena localitzada guarda un valor per idioma — per exemple Title = "Benvinguda" en català i "Welcome" en anglès, a la mateixa instància.

Com funciona el valor

Una cadena localitzada porta tots els idiomes alhora:

  • L'idioma per defecte del tenant és la versió canònica. És la que es mostra quan no n'aplica cap altra, i és obligatòria — una instància no pot tenir una cadena localitzada amb només una traducció que no sigui la per defecte.
  • Cada idioma admès pot tenir el seu propi text. Els idiomes que deixis buits simplement no tenen entrada; el lector recau en el per defecte.
  • Quan algú canvia l'idioma de visualització, la versió corresponent apareix immediatament. No es torna a demanar res — tots els idiomes viatgen junts amb la instància.

Així, un Title amb "Welcome" (en) / "Benvinguda" (ca) / "Bienvenida" (es) mostra la paraula correcta a l'instant que el lector canvia d'idioma, sense recarregar.

Editar una cadena localitzada

L'editor mostra un únic camp per a l'idioma de visualització actiu, etiquetat amb el seu codi (per exemple Title (CA)). Escriu-hi per fixar el valor d'aquell idioma.

Al costat del camp hi ha un botó 🌐. Obre un diàleg amb un camp per cada idioma admès, així pots omplir o revisar totes les traduccions en un sol lloc. Deixa un idioma en blanc per treure'n la versió; l'idioma per defecte ha de mantenir un valor.

Filtrar

Quan filtres una llista per una cadena localitzada, la coincidència es fa a tots els idiomes — és un OR. Cercar "benvinguda" a Title troba la instància tant si "benvinguda" és al text català, a l'anglès o a qualsevol altre idioma. No cal saber en quin idioma es va introduir un valor per trobar-lo.

Cadena localitzada vs cadena

Tria el tipus pel que és el camp, no per si avui ets multiidioma o no.

Fes servir cadena quan… Fes servir cadena localitzada quan…
El valor és el mateix en tots els idiomes. El valor és text per a persones que s'hauria de traduir.
És un codi, slug, identificador, URL o correu. És un nom, títol, etiqueta o descripció que la gent llegeix.
És intern i mai es mostra traduït. L'idioma de la interfície hauria de canviar el que veu el lector.

Una cadena és més lleugera i simple — segueix usant-la per a codis i text orientat a màquines. Recorre a la cadena localitzada només on la traducció importa de debò; no pots filtrar ni validar una cadena "per idioma" perquè només té un valor, i no vols aquest sobrecost on no aporta res.

On la trobes

Quan afegeixes o edites una propietat d'un model, tria cadena localitzada com a tipus. A partir d'aleshores, cada formulari d'instància mostra l'editor localitzat descrit més amunt, i els idiomes admesos surten de la configuració d'idiomes del teu tenant (vegeu Tenants).