Dokumentācija: Labākās prakses

Labākā prakse

Latvian

Ievietojiet URL mainīgajos

Tulkojot virknes, kas satur URL vai tamlīdzīgus datus, ieteicams ievietot šos URL mainīgajos un pēc tam atsaukties uz tiem savos šablonos.

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

Tulkodot tādus interaktīvus elementus kā pogas, ir svarīgi iekļaut ARIA etiķetes, lai nodrošinātu pieejamību. ARIA etiķetes palīdz ekrāna lasītājiem sniegt aprakstošu informāciju par elementa funkciju.

Piemēram, ja jums ir poga, kas ļauj lietotājiem kopēt tekstu no koda bloka, varat izmantot atribūtu aria-label, lai norādītu skaidru aprakstu:

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

Šķiet, ka šeit kaut kas ir ļoti meta.

Globālais originu masīvs un vairāki komponentu origini

Šī pieeja darbojas tikai, ja izmanto Next.js Pages Router.

Strādājot ar lielākām lietojumprogrammām, ir lietderīgi sadalīt teksta virknes un tulkojumus vairākos, mazākos avotos. Šāda pieeja palīdz samazināt pakešu izmērus un pārsūtīšanas laikus, nodrošinot efektīvu un mērogojamu lokalizāciju.

Kaut arī tas ir vienkārši, ja renderēšana notiek tikai klienta pusē, avotu pārvaldība ātri kļūst sarežģīta, kad tiek iegūti tulkojumi servera puses renderēšanai. Tomēr jūs varat automatizēt avotu pārvaldību, izmantojot TacoTranslate klienta origins masīvu.

Apsveriet šo piemēru, kur mūsu komponenti un lapas ir sadalīti atsevišķos failos.

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

Skatiet mūsu servera puses renderēšanas piemērus, lai iegūtu vairāk informācijas par getTacoTranslateStaticProps.

Kļūdu apstrāde un atkļūdošana

Labākā prakse

Izmantojiet ARIA etiķetes

Globālais originu masīvs un vairāki komponentu origini