Փաստաթուղթ՝ առաջադեմ օգտագործում

Ընդլայնված օգտագործում

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 պրովայդերների օգտագործումից, դուք կարող եք նաև չեղարկել ինչպես արմատը, այնպես էլ տեղանքը 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" />
	);
}

Օրինակ, header login-ը կարող է թարգմանվել որպես “Iniciar sesión”, իսկ footer login-ը կարող է թարգմանվել որպես “Acceder” իսպաներեն։

Լավագույն գործելակերպեր