TacoTranslate
/
DokumentācijaCenas
 
  1. Ievads
  2. Sākt darbu
  3. Uzstādīšana un konfigurēšana
  4. TacoTranslate lietošana
  5. Servera puses renderēšana
  6. Papildu izmantošana
  7. Labākās prakses
  8. Kļūdu apstrāde un atkļūdošana
  9. Atbalstītās valodas

Labākās prakses

Ievietojiet URL adreses mainīgajos.

Tulkojot virknes, kas satur URL vai līdzīgus datus, ir laba prakse ievietot šos URL mainīgajos un pēc tam atsaukties uz tiem veidņos.

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

Izmantojiet ARIA etiķetes

Tulkodami interaktīvu elementu, piemēram, pogu, tekstu, 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 aria-label atribūtu, lai sniegtu skaidru aprakstu:

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

Kaut kas šajā šķiet ļoti meta.

Globālais origins masīvs un vairāki komponentu origins

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

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

Lai gan tas ir vienkārši, ja renderē tikai klienta pusē, avotu pārvaldība ātri kļūst sarežģīta, kad jāiegūst 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ēs esam atdalījuši savus komponentus un lapas 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 uzzinātu vairāk par getTacoTranslateStaticProps.

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

Produkts no NattskiftetRažots Norvēģijā