Zprávy v Reactu
Uchovávejte zdrojový text i kontext přímo v komponentách a vykreslujte přeložené katalogy s hodnotami, gramatickými pravidly a prvky Reactu.
Zpráva v komponentě patří k akci, kterou vysvětluje. „Uložit“ ve formuláři odešle změny, zatímco „Uložit“ u článku vytvoří záložku. Když zdrojový text uchováváte spolu s jeho významem, překladatelé tento rozdíl vidí a vývojáři rozumějí komponentě, aniž by museli hledat klíč v jiném souboru.
@lingo.dev/react používá explicitní volání zpráv:
import { useLingo } from "@lingo.dev/react";
export function SaveButton() {
const l = useLingo();
return <button type="submit">{l.text("Save", { context: "Submit changes to account settings" })}</button>;
}Zdrojový text a kontext určují zprávu v katalogu, tedy mapě klíčů na přeložené řetězce. Poskytovatel dodává katalog a aktivní jazyk. Komponenta obdrží přeložený text, nebo původní zdrojový text, pokud položka chybí či je prázdná.
Od komponenty k jinému jazyku #
Nejprve vykreslete lokální překlad. Na malém katalogu uvidíte, jak vyhledávání funguje, bez účtu i bez síťového požadavku.
V rámci workflow aplikace lingo extract shromažďuje rozpoznatelná volání do zdrojového katalogu JSONC a generuje typové deklarace pro TypeScript. CLI tento soubor odešle k překladu a stáhne cílový soubor. Zavaděč pak soubor převede na mapu řetězců pro poskytovatele. Dokument Extrakce a načítání katalogů vás provede celým procesem včetně toho, jak zachovat aktivní zprávy, pokud přeložený soubor JSONC přijde o komentáře s metadaty.
Vykreslování probíhá lokálně. Běhové prostředí nekomunikuje s lokalizačním engine ani neobsahuje klíč API. Překlad na serveru ponechte v integraci API; výsledné katalogy předávejte aplikaci v rámci běžného sestavení nebo načítání při zpracování požadavku.
Napište zprávu, kterou čtenář potřebuje #
Místo spojování samostatně přeložených úryvků použijte celou větu se zástupnými symboly. V jiném jazyce může jméno, počet nebo odkaz patřit na jiné místo ve větě.
| Co zpráva potřebuje | Co použít |
|---|---|
| Prostý text s hodnotami | l.text. |
| Odkazy, zvýraznění nebo jiný prvek Reactu | l.rich s pojmenovanými funkcemi zpětného volání pro vykreslování. |
| Gramatické tvary podle počtu nebo výběr podle kategorie | l.plural a l.select. |
| Čísla, data, seznamy nebo textové operace zohledňující jazyk | Formátovací metody, které využívají nativní Intl. |
Referenční dokumentace k poskytovateli a hookům vysvětluje vnořené katalogy i použití createLingo v kódu mimo komponenty. Metadata jazyka poskytují informace o směru textu, písmu a regionu, které vám pomohou promyšleně nastavit dokument i jeho rozvržení.
Propojte zprávy se zbytkem aplikace #
Adaptéry Next.js Pages a TanStack Start propojují katalogy s příslušnými systémy směrování. V jiném prostředí načtěte jazyk a zprávy před vykreslením a tuto dvojici zachovejte i během vykreslování na serveru a hydratace.
Pomocí generovaných typů odhalíte chyby ve zdrojovém textu, kontextu a hodnotách už při úpravách. Pomocí testů vykreslování ověříte skutečně načtené šablony. Pokud se překlad nezobrazí, průvodce řešením problémů vás provede vyhledáváním od komponenty až po katalog.
Exporty #
Kořenový modul exportuje LingoProvider, useLingo, createLingo a computeKey a také typy LingoProviderProps, Lingo, Messages, LingoMessages, MessageKey, TextOptions, RichOptions, PluralForms, SelectForms a FormatMethods. Samostatný vstupní bod @lingo.dev/react/testing exportuje withLingo a renderStatic.