Dokumentácia: Najlepšie postupy

Odporúčané postupy

Slovak

Uložte URL 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 odkazovať vo vašich šablónach.

<Translate
	string={`Click <a href="{{url}}">here</a>`}
	variables={{url: 'https://tacotranslate.com'}}
/>

Pri preklade textu interaktívnych prvkov, ako sú tlačidlá, je dôležité zahrnúť ARIA štítky, aby sa zabezpečila prístupnosť. ARIA štítky pomáhajú čítačkám obrazovky poskytovať popisné informácie o funkcii prvku.

Napríklad, ak máte tlačidlo, ktoré umožňuje používateľom kopí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"
/>

Niečo na tom pôsobí veľmi meta.

Globálne pole originov a viacero originov pre komponenty

Tento vzor funguje iba pri použití Next.js Pages Router.

Pri práci na väčších aplikáciách 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.

Zatiaľ čo je to pri renderovaní iba na klientskej strane jednoduché, správa originov sa pri získavaní prekladov pre renderovanie na strane servera rýchlo stáva zložitou. Avšak správu originov môžete automatizovať využitím poľa klienta TacoTranslate origins.

Zvážte tento príklad, kde sme naše komponenty a stránky rozdelili do samostatných súborov.

components/pricing-table.tsx

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>
	);
}

pages/pricing.tsx

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.

Riešenie chýb a ladenie

Odporúčané postupy

Používanie ARIA štítkov

Globálne pole originov a viacero originov pre komponenty