డాక్యుమెంటేషన్: ఉన్నత పరిమితి ఉపయోగం

అధునిక వినియోగం

Telugu

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

TacoTranslate మీ React యాప్లికేషన్లలో అరబిక్ మరియు హ్బ్రూ వంటి కుడి నుండి ఎడమకు (RTL) భాషలను మద్దతు ఇవ్వడం సులభం చేస్తుంది. RTL భాషలను సరితైన విధంగా నిర్వహించడం means కుడి నుండి ఎడమ వైపు చదివే వినియోగదారులకు మీ కంటెంట్ సరిగ్గా ప్రదర్శించబడుతుందని నిర్ధారిస్తుంది.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

మీరు ప్రస్తుత భాషను React బయట తనిఖీ చేయడానికి అందించిన isRightToLeftLocaleCode ఫంక్షన్‌ను కూడా ఉపయోగించవచ్చు.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

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

స్ట్రింగ్‌లోని కొన్ని భాగాల అనువాదాన్ని నిలిపివెయ్యడానికి లేదా కొన్ని సెగ్మెంట్లు అస-is‌గా ఉంచడానికి, మీరు triple square brackets ఉపయోగించవచ్చు. ఈ ఫీచర్ పేర్ల, సాంకేతిక పదాలు లేదా అనువాదం చేయాల్సిన అవసరం లేని ఇతర ఎటువంటి కంటెంట్ యొక్క అసలు ఆకారాన్ని నిలుపుకోవడానికి ఉపయోగపడుతుంది.

import {Translate} from 'tacotranslate/react';

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

ఈ ఉదాహరణలో, “TacoTranslate” అనే పదం అనువాదంలో మార్చబడదు.

బహుళ TacoTranslate ప్రొవైడర్లు

మీర inyong appలో బహుళ 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ను జోడించవచ్చు. ఇది ప్రత్యేక సందర్భంలో ఒకే టెక్స్ట్‌కు వేర్వేరు అనువాదాలు అవసరం అయినప్పుడు చాలా ఉపయోగకరం. ప్రత్యేకమైన 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”గా స్పానిష్ భాషలో అనువదించబడవచ్చు.

ఉత్తమ ఆచారాలు