డాక్యుమెంటేషన్: అధునాతన వినియోగం

అధునాతన ఉపయోగాలు

Telugu

కుడి నుండి ఎడమ వైపు భాషలను నిర్వహించడం

TacoTranslate మీ React అనువర్తనాల్లో అరబిక్ మరియు హెబ్రూ వంటి కుడి నుంచి ఎడమకు (RTL) భాషలను సపోర్ట్ చేయడం సులభంగా చేస్తుంది. 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';
	// ...
}

అనువాదాన్ని నిలిపివేయడం

స్ట్రింగ్‌లోని నిర్దిష్ట భాగాల అనువాదాన్ని నిలిపివేయడానికి లేదా కొన్ని భాగాలను అలాగే నిలిపి ఉంచడానికి, మీరు మూడు చతురస్ర బ్రాకెట్లు (triple square brackets) ఉపయోగించవచ్చు. ఇది పేర్లు, సాంకేతిక పదాలు లేదా అనువదించవద్దని భావించే ఇతర విషయాల అసలు ఫార్మాట్‌ను నిలిపివేయడానికి ఉపయోగపడుతుంది.

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

బహుభాషలు

ఒకే అనువర్తనంలో ఒకేసారి బహుభాషలను మద్దతు చేయడానికి, మీరు దిగువన చూపినట్లుగా వేర్వేరు locale విలువలతో అనేక TacoTranslate ప్రొవైడర్లను ఉపయోగించవచ్చు:

మీరు కూడా 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”గా స్పానిష్‌లో అనువదించబడవచ్చు.

ఉత్తమ ఆచరణలు