Փաստաթուղթ. Գերազանցված օգտագործում

Բարձր մակարդակի օգտագործում

Armenian

Եվ աջից դեպի ձախ լեզուների մշակումը

TacoTranslate–ը հեշտացնում է աջից ձախ (RTL) ուղղությամբ լեզուների, օրինակ՝ արաբերեն և հեբրայերեն, աջակցության իրականացումը ձեր React ծրագրերում։ RTL լեզուների ճիշտ մշակումը ապահովում է, որ ձեր բովանդակությունը ճիշտ ցուցադրվի նրանց համար, ովքեր կարդում են աջից ձախ։

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Դուք կարող եք նաև օգտագործել տրամադրված isRightToLeftLocaleCode ֆունկցիան՝ ստուգելու համար ընթացիկ լեզուն React մահմա՛տից դուրս:

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Թարգմանության անջատում

Ուրույն մասերի թարգմանությունը դադարեցնելու համար կամ որոշ հատվածներն անփոփոխ պահելու նպատակով դուք կարող եք օգտագործել եռակի քառակուսի փակագծեր . Այս հատկությունը օգտակար է անունների, տեխնիկական տերմինների կամ ցանկացած այլ բովանդակության բնօրինակ ձևաչափը պահպանելու համար, որը չպետք է թարգմանվի։

import {Translate} from 'tacotranslate/react';

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

Այս օրինակում, «TacoTranslate» բառը չի փոխվի թարգմանության մեջ։

Կրկնակի TacoTranslate մատակարարներ

Մենք ջերմորեն հորդորում ենք օգտագործել մի քանիսը TacoTranslate պրովայդերներ ձեր հավելվածում։ Սա օգտակար է ձեր թարգմանությունները և տողերը կազմակերպելու համար տարբեր սկզբնավորումներում, օրինակ՝ ձեր վերնագիրում, ներքևի հատվածում կամ հատուկ բաժիններում։

Դուք կարող եք այստեղ ավելի մանրամասն կարդալ ելակետերի օգտագործման մասին։

TacoTranslate պրովայդերները ժառանգում են կարգավորումները ցանկացած ծնողական պրովայդերից, այդ պատճառով դուք ստիպված չեք լինի կրկնել այլ կարգավորումներ։

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>
	);
}

Անցում կատարելը սկզբնաղբյուրի կամ տեղանքի վրայից

Բազմաթիվ TacoTranslate պրովայդերների օգտագործման lisäksi կարող եք նաև չեղարկել ինչպես սկզբնաղբյուրը, այնպես էլ տեղայնացումը Translate կոմպոնենտի և useTranslation հուքների մակարդակներում:

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

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

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

Բեռնման կառավարում

Հաճախորդի կողմից լեզուն փոխելիս, թարգմանությունների ներբեռնումը կարող է որոշ ժամանակ տևել՝ կախված օգտագործողի կապի արագությունից։ Դուք կարող եք ցուցադրել բեռնման ցուցիչ՝ օգտագործողի փորձը բարելավելու և փոխման ընթացքում տեսողական արձագանք ապահովելու համար։

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Բազմացում

Բազմացման և ցուցադրման վրա հիմնված պիտակները ճիշտ դարձնելու համար տարբեր լեզուներում, սա համարվում է լավագույն փորձ:

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)}}
		/>
	);
}

Մեկնարկել լեզուներ

Միաժամանակ մի քանի լեզուների աջակցությունն նույն հավելվածում, կարող եք օգտագործել մի քանի TacoTranslate պրովայդերներ՝ տարբեր locale արժեքներով, ինչպես ցույց է տրված ստորև:

Դուք կարող եք նաև վերագրել locale կոմպոնենտի կամ հուկի մակարդակում:

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>
	);
}

Թարգմանության ID-ների օգտագործում

Դուք կարող եք ավելացնել id Translate բաղադրիչին՝ միևնույն տողիկի տարբեր թարգմանություններ կամ նշանակություններ կարգավորելու համար: Այն հատկապես օգտակար է, երբ նույն տեքստը պահանջում է տարբեր թարգմանություններ ըստ կոնտեքստի: Մասնակի եզակի ID-ների նշանակմամբ դուք ապահովում եք, որ տողիկի յուրաքանչյուր օրինակ փոխադրվի ճշգրիտ՝ ըստ նրա հատուկ նշանակության:

import {Translate} from 'tacotranslate/react';

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

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

Օրինակ, գլխամասի մուտքը կարող է թարգմանվել որպես «Iniciar sesión», իսկ ստորագրի մուտքը՝ որպես «Acceder» իսպաներեն լեզվում։

Լավագույն փորձերը