Dokumentācija: Papildu izmantošana

Papildu izmantošana

Latvian

Darbs ar valodām ar rakstību no labās uz kreiso

TacoTranslate atvieglo valodu, kas rakstās no labās uz kreiso pusi (RTL), piemēram, arābu un hebreju, atbalstīšanu jūsu React lietotnēs. Pareiza RTL valodu apstrāde nodrošina, ka jūsu saturs tiek pareizi attēlots lietotājiem, kuri lasa no labās uz kreiso pusi.

import {useTacoTranslate} from 'tacotranslate/react';

function Document() {
	const {locale, isRightToLeft} = useTacoTranslate();

	return (
		<html lang={locale} dir={isRightToLeft ? 'rtl' : 'ltr'}>
			<body>
				// ...
			</body>
		</html>
	);
}

Jūs varat arī izmantot nodrošināto isRightToLeftLocaleCode funkciju, lai pārbaudītu pašreizējo valodu ārpus React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

function foo(locale = 'es') {
	const direction = isRightToLeftLocaleCode(locale) ? 'rtl' : 'ltr';
	// ...
}

Tulkošanas atspējošana

Lai atspējotu tulkošanu konkrētām virknes daļām vai nodrošinātu, ka noteikti segmenti tiek saglabāti nemainīti, varat izmantot trīs kvadrātiekavas. Šī funkcija ir noderīga, lai saglabātu vārdu, tehnisko terminu vai jebkura cita satura oriģinālo formātu, kas nedrīkst tikt tulkots.

import {Translate} from 'tacotranslate/react';

function Component() {
	return (
		<Translate string="Hello, [[[TacoTranslate]]]!" />
	);
}

Šajā piemērā vārds “TacoTranslate” paliks nemainīts tulkojumā.

Vairāki TacoTranslate pakalpojumu sniedzēji

Mēs stingri iesakām jūsu lietotnē izmantot vairākus TacoTranslate pakalpojumu sniedzējus. Tas noder, lai organizētu jūsu tulkojumus un teksta virknes dažādos avotos, piemēram, galvenē, kājenē vai noteiktās sadaļās.

Varat uzzināt vairāk par origins izmantošanu šeit.

TacoTranslate nodrošinātāji pārmanto iestatījumus no jebkura vecāka nodrošinātāja, tāpēc jums nebūs jāatkārto pārējie iestatījumi.

import createTacoTranslateClient from 'tacotranslate';
import {TacoTranslate} from 'tacotranslate/react';

const tacoTranslateClient = createTacoTranslateClient({apiKey: 'YOUR_API_KEY'});

function Header() {
	return (
		<TacoTranslate origin="header">
			// ...
		</TacoTranslate>
	);
}

function Menu() {
	return (
		<TacoTranslate origin="menu">
			// ...
		</TacoTranslate>
	);
}

export default function App() {
	return (
		<TacoTranslate client={tacoTranslateClient} origin="page" locale="es">
			<Header />
			<Menu />
		</TacoTranslate>
	);
}

Izcelsmes vai lokāles pārrakstīšana

Papildus vairāku TacoTranslate sniedzēju izmantošanai jūs varat arī pārdefinēt gan origin, gan locale Translate komponenta un useTranslation hook līmeņos.

import {Translate, useTranslation} from 'tacotranslate/react';

function Greeting() {
	const spanishHello = useTranslation('Hello!', {locale: 'es'});

	return (
		<>
			{spanishHello}
			<Translate string="What’s up?" origin="greeting" />
		</>
	);
}

Ielādes apstrāde

Mainot valodu klienta pusē, tulkojumu ielāde var aizņemt dažus mirkļus atkarībā no lietotāja savienojuma. Lai uzlabotu lietotāja pieredzi, varat rādīt ielādes indikatoru, kas sniedz vizuālu atgriezenisko saiti pārejas laikā.

import {useTacoTranslate} from 'tacotranslate/react';

function Component() {
	const {isLoading} = useTacoTranslate();

	return (
		isLoading ? 'Translations are loading...' : null
	);
}

Pluralizācija

Lai pareizi apstrādātu daudzskaitli un attēlotu ar skaitu saistītas etiķetes dažādās valodās, to uzskata par labāko praksi:

import {Translate, useLocale} from 'tacotranslate/react';

function PhotoCount() {
	const locale = useLocale();
	const count = 1;

	return count === 0 ? (
		<Translate string="You have no photos." />
	) : count === 1 ? (
		<Translate string="You have 1 photo." />
	) : (
		<Translate
			string="You have {{count}} photos."
			variables={{count: count.toLocaleString(locale)}}
		/>
	);
}

Vairākas valodas

Lai vienlaikus atbalstītu vairākas valodas tajā pašā lietotnē, jūs varat izmantot vairākus TacoTranslate pakalpojumu sniedzējus ar dažādām locale vērtībām, kā parādīts zemāk:

Varat arī pārrakstīt locale komponenta vai hooka līmenī.

import createTacoTranslateClient from 'tacotranslate';
import {TacoTranslate, Translate} from 'tacotranslate/react';

const tacoTranslateClient = createTacoTranslateClient({apiKey: 'YOUR_API_KEY'});

function Spanish() {
	return (
		<TacoTranslate locale="es">
			<Translate string="Hello, world in Spanish!" />
		</TacoTranslate>
	);
}

function Norwegian() {
	return (
		<TacoTranslate locale="no">
			<Translate string="Hello, world in Norwegian!" />
		</TacoTranslate>
	);
}

export default function App() {
	return (
		<TacoTranslate client={tacoTranslateClient} origin="page" locale="es">
			<Spanish />
			<Norwegian />
		</TacoTranslate>
	);
}

Tulkojumu ID izmantošana

Jūs varat pievienot id komponentam Translate, lai apstrādātu dažādus tulkojumus vai nozīmes vienai un tai pašai virknei. Tas ir īpaši noderīgi, ja tas pats teksts prasa dažādus tulkojumus atkarībā no konteksta. Piešķirot unikālus ID, jūs nodrošināt, ka katra šīs virknes instance tiek precīzi tulkota atbilstoši tās konkrētajai nozīmei.

import {Translate} from 'tacotranslate/react';

function Header() {
	return (
		<Translate id="header" string="Login" />
	);
}

function Footer() {
	return (
		<Translate id="footer" string="Login" />
	);
}

Piemēram, galvenes pieteikšanās var tikt tulkota kā “Iniciar sesión”, un kājenes pieteikšanās var tikt tulkota kā “Acceder” spāņu valodā.

Labākā prakse