Dokimantasyon: Pi bon pratik

Pi bon pratik

Haitian Creole

Mete URL yo nan varyab

Lè w ap tradui chenn karaktè ki gen URL oswa lòt done menm jan, 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 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 ki fè li santi l vrèman meta.

Tablo 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 ak aplikasyon ki pi gwo, li itil pou separe strings ak tradiksyon yo an plizyè orijin ki pi piti. Apwòch sa a ede diminye gwosè pake yo ak tan transfè yo, sa ki asire yon lokalizasyon efikas e ki kapab agrandi.

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

Konsidere egzanp sa a, kote nou te separe konpozan ak paj nou yo nan dosye 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.

Jere erè ak debogaj

Pi bon pratik

Sèvi ak etikèt ARIA

Tablo orijin global ak plizyè orijin pou konpozan