Zprávy s formátovaným textem

Překládejte celé věty a cíle odkazů i chování Reactu ponechte v kódu aplikace.

Odkaz často patří přímo do věty. Když slova před odkazem, v něm a za ním překládáte zvlášť, nutíte překlad zachovat slovosled zdrojového jazyka. l.rich umožňuje překládat větu jako celek a v přeložené šabloně umístit pojmenované prvky Reactu tam, kam patří.

Nechte větu pohromadě #

tsx
import { useLingo } from "@lingo.dev/react";

export function PurchaseNotice({ product }: { product: string }) {
  const l = useLingo();
  return (
    <p>
      {l.rich("Read the <link>refund policy</link> before buying {product}.", {
        context: "Purchase notice linking to the refund policy",
        values: { product },
        tags: {
          link: (children) => <a href="/refund-policy">{children}</a>,
        },
      })}
    </p>
  );
}

Tuto komponentu vykreslete pod komponentou poskytovatele. Zdrojový text a kontext určují položku katalogu stejně jako u l.text. Přeložená šablona určuje znění a umístění značek; funkce zpětného volání zajišťuje cíl odkazu, atributy, stylování a chování.

l.rich vrací ReactNode. Jeho RichOptions vyžaduje context, přijímá mapu values s řetězcovými nebo číselnými hodnotami a také tags: Record<string, (children: ReactNode) => ReactNode>. Názvy značek se musí přesně shodovat, takže <link> vyžaduje funkci zpětného volání link.

Vložte prvek bez potomků #

Samouzavírací značka volá svou vykreslovací funkci s hodnotou null pro potomky. Například následující potvrzení umístí za zprávu dekorativní ikonu:

tsx
const confirmation = l.rich("Saved <icon/>", {
  context: "Confirmation that account settings were saved",
  tags: {
    icon: () => <span aria-hidden="true">✓</span>,
  },
});

Zde l představuje výsledek useLingo() komponenty. Podporovány jsou <icon/> i <icon />. Pro vnořené prvky používejte odlišné názvy, například <link><strong>refund policy</strong></link>, a poskytněte obě funkce zpětného volání. Parser použije následující odpovídající uzavírací značku; vnořené značky se stejným názvem nezpracovává jako správně spárovanou strukturu HTML.

Kontrolujte nejen přeložená slova, ale i značky #

Pokud pro párovou nebo samouzavírací značku chybí funkce zpětného volání, značka zůstane doslovným textem. Totéž platí pro otevírací značku bez odpovídající uzavírací značky. Zprávu tak lze stále vykreslit, čtenář ale může místo funkčního odkazu vidět <link>.

Otestujte přeloženou šablonu s funkcemi zpětného volání, které skutečně používá. Ověřte text odkazu a href a zahrňte i případ s chybějící značkou, abyste při vývoji odhalili nechtěné značky. Testy vykreslování nevyžadují odeslání požadavku na překlad.

Podporovány jsou pojmenované značky, nikoli libovolné HTML. Atributy zadávejte ve funkci zpětného volání, ne přímo v překladu. Použitím dangerouslySetInnerHTML ke zpracování značky bez odpovídajícího protějšku byste toto oddělení narušili.

Ve zprávách s formátovaným textem používejte jednoduché hodnoty #

Formátovaný text nahrazuje v textových úsecích jednoduché hodnoty {name}. Nespouští komplexní formátovač ICU, který používá l.text. Pro gramatické tvary závislé na množství použijte plurály a výběry nebo rozhraní navrhněte tak, aby pracovalo s úplnými, gramaticky správnými zprávami, které lze vyjádřit podporovanou reprezentací formátovaného textu. Samotný zápis plurálu ICU v šabloně formátovaného textu nezajistí volbu správného tvaru jen proto, že obsahuje složené závorky.