დოკუმენტაცია: მოწინავე გამოყენება

დამუშავებული გამოყენება

Georgian

მარჯვენიდან მარცხნივ მიმართულების ენების მართვა

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 პროვაიდერის გამოყენების გარდა, შეგიძლიათ ასევე გადააფაროთ ორივე origin და locale 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” ესპანურად.

საუკეთესო პრაქტიკა