Dokumentācija: Papildu lietošana

Papildu lietošana

Latvian

Darbs ar valodām, kas rakstītas no labās uz kreiso

TacoTranslate atvieglo atbalstu valodām ar rakstību no labās uz kreisās puses (RTL), piemēram, arābu un ebreju valodām, jūsu React lietotnēs. Pareiza šo valodu apstrāde nodrošina, ka jūsu saturs tiek pareizi attēlots lietotājiem, kuri lasa no labās uz kreisās puses.

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 teksta daļām vai nodrošinātu, ka noteikti segmenti tiek saglabāti tādi, kādi ir, varat izmantot trīskāršas kvadrātiekavas. Šī funkcija ir noderīga, lai saglabātu sākotnējo formātu personvārdiem, tehniskiem terminiem vai citam saturam, kas nav paredzēts tulkošanai.

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 izmantot vairākus TacoTranslate pakalpojumu sniedzējus jūsu lietotnē. Tas ir noderīgi, lai organizētu jūsu tulkojumus un virknes dažādos originos, piemēram, galvenē, kājenē vai konkrētās sadaļās.

Jūs varat lasīt vairāk par originu 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žas sekundes 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 daudzskaitļa formas 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:

Jūs 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 Translate komponentam, lai apstrādātu dažādus tulkojumus vai nozīmes vienai un tai pašai virknei. Tas ir īpaši noderīgi, ja vienai un tai pašai frāzei kontekstā nepieciešami atšķirīgi tulkojumi. Piešķirot unikālus ID, jūs nodrošināt, ka katra šīs virknes instance tiek tulkota precīzi, 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 spāņu valodā var tikt tulkota kā “Iniciar sesión”, bet kājenes pieteikšanās — kā “Acceder”.

Labākā prakse