Dokimantasyon: Pi bon pratik

Pi bon pratik

Haitian Creole

Mete URL yo nan varyab

Lè w ap tradui chenn tèks ki gen ladan URL oswa done ki sanble, li konsidere kòm yon bon pratik pou mete URL sa yo nan varyab epi refere yo nan modèl ou yo.

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

Lè w ap tradui tèks eleman entèaktif tankou bouton, li enpòtan pou enkli etikèt ARIA pou asire aksesibilite. Etikèt ARIA ede lektè ekran yo bay enfòmasyon deskriptif sou fonksyon eleman an.

Pa egzanp, si ou gen yon bouton ki pèmèt itilizatè yo kopye tèks ki soti nan yon blòk kòd, ou ka itilize atribit aria-label la pou bay yon deskripsyon klè:

<Translate
	aria-label={useTranslation('Copy to clipboard')}
	string="Copy"
/>

Gen yon bagay ladan l ki fè li santi l vrèman meta.

Tab orijin global ak plizyè orijin pou konpozan

Modèl sa a mache sèlman lè w ap itilize Next.js Pages Router.

Lè w ap travay sou aplikasyon ki pi gwo, li benefik pou divize chenn tèks ak tradiksyon yo an plizyè origins ki pi piti. Apwòch sa a ede diminye gwosè pake ak tan transfè, sa ki asire yon lokalizasyon efikas epi ki fasil pou elaji.

Pandan sa a senp lè w ap rann sèlman sou bò kliyan an, jere origins vin rapidman konplèks lè w ap rekipere tradiksyon pou rann sou bò sèvè a. Sepandan, ou ka otomatize jesyon origins lè w itilize tablo origins nan kliyan TacoTranslate la.

Konsidere egzanp sa a, kote nou separe konpozan ak paj nou yo nan fichye apa.

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

Gade egzanp rann sou sèvè nou yo pou plis enfòmasyon sou getTacoTranslateStaticProps.

Jesyon erè ak debogaj

Pi bon pratik

Sèvi ak etikèt ARIA

Tab orijin global ak plizyè orijin pou konpozan