Dokimantasyon: Pi bon pratik

Pi bon pratik

Haitian Creole

Mete URL yo nan varyab

Lè w ap tradui chenn tèks ki gen URL oswa lòt done ki sanble, li konsidere kòm yon bon pratik pou mete URL sa yo nan varyab epi fè referans a 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 bay enfòmasyon deskriptif sou fonksyon eleman an.

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

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

Gen yon bagay nan sa a ki santi l trè meta.

Aray orijin global ak plizyè orijin konpozan

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

Lè w ap travay sou aplikasyon ki pi gwo, li itil pou separe chenn tèks ak tradiksyon yo an plizyè orijin pi piti. Apwòch sa a ede diminye gwosè pake yo ak tan transfè yo, asire yon lokalizasyon efikas e ki ka elaji.

Sa a senp lè w ap rann sèlman sou bò kliyan an, men jere orijin yo vin rapidman konplèks lè w ap jwenn tradiksyon pou rann sou sèvè a. Sepandan, ou ka otomatize jesyon orijin yo lè w itilize tablo origins kliyan TacoTranslate la.

Gade egzanp sa a, kote nou te 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

Aray orijin global ak plizyè orijin konpozan