Najlepšie postupy
Ukladajte URL adresy do premenných
Pri prekladaní reťazcov, ktoré obsahujú URL alebo podobné údaje, sa považuje za dobrú prax umiestniť tieto URL do premenných a potom na ne v šablónach odkazovať.
<Translate
string={`Click <a href="{{url}}">here</a>`}
variables={{url: 'https://tacotranslate.com'}}
/>
Používajte ARIA popisky
Pri prekladaní textu interaktívnych prvkov, ako sú tlačidlá, je dôležité zahrnúť ARIA popisky, aby bola zabezpečená prístupnosť. ARIA popisky pomáhajú čítačkám obrazovky poskytovať opisné informácie o funkcii prvku.
Napríklad ak máte tlačidlo, ktoré umožňuje používateľom skopírovať text z bloku kódu, môžete použiť atribút aria-label
na poskytnutie jasného popisu:
<Translate
aria-label={useTranslation('Copy to clipboard')}
string="Copy"
/>
Na tom je niečo veľmi meta.
Globálne pole pôvodov a viacero pôvodov pre komponenty
Tento vzor funguje iba pri používaní Next.js Pages Router.
Pri práci s väčšími aplikáciami je výhodné rozdeliť reťazce a preklady do viacerých, menších originov. Tento prístup pomáha znižovať veľkosť balíkov a časy prenosu, čím zabezpečuje efektívnu a škálovateľnú lokalizáciu.
Aj keď je to jednoduché pri vykresľovaní iba na klientovi, správa originov sa pri získavaní prekladov pre vykresľovanie na strane servera rýchlo stáva zložitou. Môžete však automatizovať správu originov pomocou poľa origins
klienta TacoTranslate.
Pozrite si tento príklad, kde sme naše komponenty a stránky rozdelili do samostatných súborov.
import TacoTranslate, {Translate} from 'tacotranslate/react';
import tacoTranslate from '../tacotranslate-client';
// Set an origin name for this component
const origin = 'components/pricing-table';
// Push the origin into the origins array as this file is imported
tacoTranslate.origins.push(origin);
export default function PricingTable() {
return (
<TacoTranslate origin={origin}>
<Translate string="Pricing table" />
// ...
</TacoTranslate>
);
}
import TacoTranslate, {Translate} from 'tacotranslate/react';
import getTacoTranslateStaticProps from 'tacotranslate/next/get-static-props';
import tacoTranslateClient from '../tacotranslate-client';
import PricingTable from '../components/pricing-table';
const origin = 'pages/pricing';
tacoTranslateClient.origins.push(origin);
export default function PricingPage() {
return (
<TacoTranslate origin={origin}>
<Translate string="Pricing page" />
<PricingTable />
</TacoTranslate>
);
}
// We will now fetch translations for all imported components and their origins automatically
export async function getStaticProps(context) {
return getTacoTranslateStaticProps(context, {client: tacoTranslateClient});
}
Pozrite si naše príklady vykresľovania na strane servera pre viac informácií o getTacoTranslateStaticProps
.