डॉक्युमेंटेशन: प्रगत वापर

प्रगत वापर

Marathi

डावीकडून उजवीकडे लिहिणाऱ्या भाषांचे व्यवस्थापन

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

अनुवाद अक्षम करणे

एखाद्या स्ट्रिंगच्या विशिष्ट भागासाठी भाषांतर अक्षम करण्यासाठी किंवा काही विभाग जसे आहेत तसे ठेवण्यासाठी, आपण त्रिशतचौरस कोष्ठके वापरू शकता. ही वैशिष्ट्ये नावे, तांत्रिक संज्ञा किंवा इतर कोणत्याही अशा सामग्रीचे मूळ स्वरूप कायम ठेवण्यासाठी उपयुक्त आहे ज्याचे भाषांतर केले जाऊ नये.

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

उत्स किंवा स्थानिक भाषा ओव्हरराईड करणे

Multiple TacoTranslate providers वापरण्याशिवाय, तुम्ही Translate घटक आणि useTranslation हुक स्तरांवर origin आणि locale दोन्ही ओव्हरराईड देखील करू शकता.

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

अनुवाद आयडी वापरणे

आपण 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” असे होऊ शकते.

सर्वोत्तम सराव