Vykreslete svou první přeloženou zprávu
Pomocí lokálního katalogu zobrazte španělský pozdrav, dosaďte jméno a ověřte, že se při chybějícím překladu použije zdrojový text.
Vykreslete Hola, Ana. z anglické zdrojové zprávy. Příklad obsahuje vlastní španělský překlad, takže přesně uvidíte, jak spolupracují komponenta, katalog a poskytovatel. Nepotřebujete účet Lingo.dev ani klíč API.
Nainstalujte balíček do aplikace v Reactu 19 #
npm install @lingo.dev/react@1.17.1Pro tento postup použijte existující aplikaci v Reactu 19. Přestože balíček deklaruje React 18 i 19 jako závislosti typu peer, jeho poskytovatel používá zkrácený zápis poskytovatele kontextu z Reactu 19. Samotná instalace balíčku do projektu v Reactu 18 nepotvrzuje, že v něm bude vykreslování fungovat.
Přidejte pozdrav a katalog #
Vložte tuto komponentu do src/App.tsx a vykreslete ji přes stávající vstupní bod aplikace:
import { computeKey, LingoProvider, useLingo } from "@lingo.dev/react";
const messages = {
[computeKey("Hello, {name}.", "Greeting on the account dashboard")]:
"Hola, {name}.",
};
function Greeting() {
const l = useLingo();
return (
<h1>
{l.text("Hello, {name}.", {
context: "Greeting on the account dashboard",
values: { name: "Ana" },
})}
</h1>
);
}
export default function App() {
return (
<LingoProvider locale="es" messages={messages}>
<Greeting />
</LingoProvider>
);
}Spusťte aplikaci příkazem pro vývojový režim a otevřete stránku. V nadpisu se zobrazí Hola, Ana. Běhové prostředí vypočítá ze zdrojového textu a kontextu stejný klíč, najde španělskou šablonu a nahradí {name} hodnotou Ana.
Katalog obsahuje celou větu, takže překlad může mít jiný slovosled. Jméno je hodnota, nikoli součást klíče; i pro jiné jméno se použije stejná položka katalogu. Ve volání l.text ponechte zdrojový text a kontext jako literály, aby je nástroj pro extrakci mohl později najít.
Ověřte, co se stane bez překladu #
Dočasně předejte poskytovateli messages={{}}. V nadpisu se nyní zobrazí Hello, Ana. Zdrojový text slouží jako náhradní šablona a dosazování hodnot funguje dál. Zdrojový text se použije i u položky s hodnotou "".
Obnovte messages a pak změňte pouze kontext volání na "Greeting on the profile page". Tím se změní identita zprávy, takže původní překlad už neodpovídá. Vraťte původní kontext a v nadpisu se opět zobrazí Hola, Ana. Těmito kontrolami rozlišíte chybějící katalog od nesouladu mezi požadovanou zprávou a zprávou, pro kterou překlad existuje.
Nahraďte lokální mapu extrahovanými katalogy #
Komponenta je připravena k extrakci. Návod Extrakce a načítání katalogů ukazuje, jak vygenerovat locales/en.jsonc, vybrat jej v konfiguraci CLI, získat španělský překlad a bezpečně jej načíst. To je další ucelený úkol. Výše uvedený lokální příklad se vám bude dál hodit jako test vykreslování.
Pokud vaše aplikace používá směrování, pokračujte návodem Next.js Pages nebo TanStack Start. Při přepínání jazyka je třeba změnit jazyk i jeho zprávy současně, aby rozhraní nikdy nekombinovalo text jednoho jazyka s formátováním jiného.