Dokumentācija: Papildu lietošana

Papildu lietošana

Latvian

Darbs ar valodām, kuras raksta no labās uz kreiso pusi

TacoTranslate padara vienkāršu atbalstu valodām, kurās raksta virziens ir no labās uz kreiso (RTL), piemēram, arābu un ebreju valodām, jūsu React lietotnēs. Pareiza RTL valodu apstrāde nodrošina, ka saturs tiek pareizi attēlots lietotājiem, kuri lasa no labās uz kreiso.

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 nodoto 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 tulkojumu noteiktām virknes daļām vai nodrošinātu, ka daži segmenti tiek saglabāti nemainīti, varat izmantot trīs kvadrātiekavas. Šī funkcija ir noderīga, lai saglabātu sākotnējo formātu nosaukumiem, tehniskiem terminiem vai jebkuram citam saturam, kas netiek tulkots.

import {Translate} from 'tacotranslate/react';

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

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

Vairāki TacoTranslate nodrošinātā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 izcelsmes punktos, piemēram, jūsu galvenē, kājenē vai konkrētās sadaļās.

Jūs varat šeit lasīt vairāk par izcelsmju izmantošanu.

TacoTranslate nodrošinātāji mantos 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 pakalpojumu sniedzēju izmantošanai jūs varat arī pārrakstīt gan izcelsmi, 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, sniedzot vizuālu atgriezenisko saiti pārslēgšanās laikā.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Daudzskaitļa forma

Lai pareizi apstrādātu daudzskaitli un attēlotu skaitļu 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ākas valodas

Lai vienlaikus atbalstītu vairākas valodas vienā 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 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>
	);
}

Tulkojumu ID izmantošana

Jūs varat pievienot id komponentam Translate lai apstrādātu dažādas tulkošanas vai nozīmes vienam un tam pašam tekstam. Tas ir īpaši noderīgi, ja vienai un tai pašai frāzei nepieciešamas dažādas tulkošanas atkarībā no konteksta. Piešķirot unikālus ID, jūs nodrošināt, ka katra frāzes instance tiek precīzi tulkota saskaņā ar tās konkrēto nozīmi.

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