Dokumentācija: Papildu lietošana

Paplašināta lietošana

Latvian

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

TacoTranslate atvieglo labo uz kreiso (RTL) valodu, piemēram, arābu un ivritas, atbalstu jūsu React lietojumprogrammās. Pareiza RTL valodu apstrāde nodrošina, ka jūsu saturs tiek pareizi attēlots lietotājiem, kas 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 funkciju isRightToLeftLocaleCode, lai pārbaudītu pašreizējo valodu ārpus React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Tulkojuma atspējošana

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

import {Translate} from 'tacotranslate/react';

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

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

Vairāki TacoTranslate pakalpojumu sniedzēji

Mēs stingri iesakām izmantot vairākus TacoTranslate nodrošinātājus jūsu lietotnē. Tas ir noderīgi, lai organizētu jūsu tulkojumus un virknes dažādos izcelsmes avotos, piemēram, galvenē, kājenē vai konkrētās sadaļās.

Jūs varat šeit izlasīt vairāk par avotu izmantošanu.

TacoTranslate nodrošinātāji pārmanto iestatījumus no jebkura vecāku nodrošinātāja, tāpēc jums nebūs jāatkārto citi 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>
	);
}

Pārrakstīt izcelsmi vai lokalizāciju

Papildus vairāku TacoTranslate nodrošinātāju izmantošanai, jūs varat arī pārrakstīt gan originu, gan lokalizāciju 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" />
		</>
	);
}

Iekraušanas apstrāde

Mainot valodu klienta pusē, tulkojumu ielāde var aizņemt dažas sekundes atkarībā no lietotāja savienojuma. Varat parādīt ielādes indikatoru, lai uzlabotu lietotāja pieredzi, nodrošinot vizuālu atgriezenisko saiti pārejot.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Daudzskaitļi

Lai pareizi apstrādātu daudzskaitli un parādītu skaitļiem atbilstošas etiķetes dažādās valodās, tas tiek uzskatīts 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āku valodu atbalsts

Lai vienlaikus atbalstītu vairākas valodas vienā un tajā pašā lietotnē, jūs varat izmantot vairākus TacoTranslate 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 hook 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>
	);
}

Tulkošanas ID izmantošana

Jūs varat pievienot id komponentam Translate, lai apstrādātu dažādas tulkojumu versijas vai nozīmes tai pašai virknei. Tas ir īpaši noderīgi, ja tas pats teksts dažādos kontekstos prasa atšķirīgus tulkojumus. Piešķirot unikālus ID, jūs nodrošināt, ka katrs virknes instances tulkojums ir precīzs un atbilst 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ās prakses