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

అధునాతన వినియోగం

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';
	// ...
}

అనువాదాన్ని అచేతనం చేయడం

స్ట్రింగ్ యొక్క నిర్దిష్ట భాగాల అనువాదాన్ని నిలిపివేయడానికి లేదా కొన్ని భాగాలు అస-is గానే ఉండాలని నిర్ధారించుకోవడానికి, మీరు మూడు స్క్వేర్ బ్రాకెట్లు ఉపయోగించవచ్చు. ఈ ఫీచర్ పేర్లు, సాంకేతిక పదాలు లేదా అనువదించకూడని ఇతర విషయాల ఒరిజినల్ ఫార్మాట్ ని నిలుపుకోవడానికి ఉపయోగపడుతుంది.

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లు ఉపయోగించడం

మీరు ఒకే స్ట్రింగ్‌కు విభిన్న అనువాదాలు లేదా అర్థాలను నిర్వహించడానికి Translate కాంపొనెంట్‌కు idను జోడించవచ్చు. ఇది ఒకే పదం సందర్భంపై ఆధారపడి విభిన్న అనువాదాలు అవసరమైనప్పుడు ప్రత్యేకంగా ఉపయోగకరం. ప్రత్యేక IDs‌ను కేటాయించడం ద్వారా, స్ట్రింగ్ యొక్క ప్రతి ఉదాహరణను దాని నిర్దిష్ట అర్థం ప్రకారం ఖచ్చితంగా అనువదించబడుతుంది అని మీరు నిర్ధారించుకుంటారు.

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” గా అనువదించవచ్చు.

ఉత్తమ ఆచరణలు