Řešení problémů se zprávami v Reactu

Zjistěte, kde se mezi extrakcí a vykreslením ztrácí překlad, hodnoty, tagy nebo jazyk zprávy.

Sledujte zprávu, která se skutečně zobrazuje na obrazovce. Její zdrojový text a kontext určují klíč, nejbližší provider poskytuje katalog a vybraná šablona se formátuje pomocí hodnot předaných při volání. Kontrola těchto vstupů obvykle odhalí příčinu problému, aniž byste museli ručně měnit vygenerované klíče.

useLingo mimo provider vyvolá výjimku #

Umístěte LingoProvider nad komponentu, která volá hook, a to i v testech a izolovaných náhledech. Provider vrácený toutéž komponentou je v hierarchii pod tímto hookem. Přesuňte hook do podřízené komponenty nebo použijte createLingo(locale, messages) ve funkci, která se nevykresluje prostřednictvím kontextu Reactu.

Pro aktuální implementaci provideru používejte React 19. Ani širší rozsah verzí v peer závislostech balíčku nezajišťuje kompatibilitu zkráceného zápisu kontextu z Reactu 19 s Reactem 18.

Místo překladu se zobrazuje zdrojový text #

  1. Zkontrolujte skutečné hodnoty locale a messages nejbližšího provideru. Zprávy musí být mapou hashů na řetězce, nikoli URL souboru, objektem Promise nebo LocaleFile.
  2. Vypočítejte computeKey(source, context) z přesné podoby volání. Poté tento klíč vyhledejte v předané mapě. Změny interpunkce, bílých znaků nebo kontextu mohou vést k nové identitě zprávy.
  3. Pokud klíč ve výsledku extrakce chybí, zadejte zdrojový text a kontext jako literály s podporovaným příjemcem volání, například l.text(...), a spusťte extrakci znovu. Dynamicky sestavené volání se může za běhu vykreslit, i když ho nelze extrahovat.
  4. Pokud zdrojový katalog klíč obsahuje, ale cílový ne, stáhněte dokončený překlad a znovu načtěte mapu. Samotným odesláním se soubor do aplikace nedostane.
  5. Pokud soubor klíč obsahuje, ale provider ne, zkontrolujte cesty a výběr trasy v načítacím modulu. V části Načítání katalogů najdete postup propojení se zdrojovými klíči, které je nutné, pokud přeložený soubor JSONC ztratil metadata.

U chybějících hodnot i prázdných řetězců se jako náhrada použije zdrojový text. Varování ve vývojovém režimu tyto dva případy rozlišují a vypisují se bez duplicit podle klíče a jazyka. V produkci se tato diagnostika potlačuje, takže prázdná konzole nepotvrzuje úplnost katalogu.

Načítací modul pro Next vrací při chybějícím souboru {}, ale při neplatném JSONC může vyvolat výjimku. Vestavěný katalog TanStack při chybějícím souboru i při chybách načítání nebo parsování vrátí {} a tento výsledek uloží do mezipaměti. V obou případech může použití zdrojového textu jako náhrady zachovat čitelnost stránky a zároveň skrýt problém s načítáním.

Zástupný symbol nebo výraz ICU zůstává viditelný #

Zkontrolujte objekt values předávaný do volání. Pokud chybí jednoduché hodnoty, zůstane {name} viditelný. Bez objektu s hodnotami vrátí běhové prostředí vybranou šablonu bez formátování.

U složitější zprávy ICU zkontrolujte syntaxi vybraného cílového překladu, názvy argumentů a typy hodnot. Při chybě parsování nebo formátování se vrátí stejná šablona a ve vývojovém režimu se vypíše chybové hlášení s potlačením duplicit. Může se tak zobrazit chybný překlad místo anglického zdrojového textu. Opravte šablonu nebo doplňte chybějící argument a poté daný případ znovu vykreslete.

Vygenerované deklarace kontrolují rozpoznané argumenty ve zdrojovém textu, ale neověřují syntaxi cílového překladu ani neodhalí každý zástupný symbol vnořený do větve ICU. Otestujte příslušnou větev se skutečnými hodnotami.

Zprávy s formátováním používají pojmenovaná zpětná volání, například tags.link. Název musí přesně odpovídat názvu tagu v překladu a cíl odkazu musí zůstat ve zpětném volání. Neznámé párové tagy, samouzavírací tagy a neuzavřené otevírací tagy zůstanou zobrazené jako doslovný text.

Pro vnořené prvky používejte odlišné názvy. Opakované vnořování tagů se stejným názvem parser nepodporuje. Zprávy s formátováním podporují jednoduché zástupné symboly, nikoli úplnou gramatiku ICU. Pro práci s ní použijte pomocné funkce pro textovou gramatiku. Podporované podoby zápisu najdete v části Formátovaný text.

URL se změní, ale jazyk ne #

Měňte jazyk a katalog společně. Změna samotného jazyka může vést k formátování francouzského textu podle španělských pravidel. Zkontrolujte také vnořené providery: podřízený provider s jiným jazykem je nezávislý a nedědí katalog nadřazeného provideru.

Řiďte se způsobem přepínání u vybraného adaptéru. Next Pages používá navigaci přes router a soubor cookie s jazykem. TanStack používá běžné odkazy, aby se nový katalog mohl načíst s novým požadavkem.

Během hydratace se mění text, směr textu nebo kalendářní data #

Porovnejte vstupy na serveru a klientovi: revizi katalogu, jazyk, hodnoty, časové razítko, časové pásmo a referenční čas pro relativní časové údaje. Nastavte lang a dir dokumentu v základní struktuře frameworku; základní provider je nemění. Poté otestujte počáteční HTML i hydratovanou stránku podle kontrolního seznamu pro vykreslování na serveru.