दस्तऐवजीकरण: प्रगत वापर

उन्नत वापर

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

स्रोत किंवा स्थानिक अधिलेखन

एकाधिक 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)}}
		/>
	);
}

एकाधिक भाषा

एकाच अनुप्रयोगात एकाच वेळी अनेक भाषा समर्थित करण्यासाठी, तुम्ही एकाधिक 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 Translate कॉम्पोनेंटमध्ये जोडू शकता जे समान स्ट्रिंगसाठी वेगवेगळ्या भाषांतर किंवा अर्थ हाताळू शकेल. हे विशेषतः उपयुक्त आहे जेव्हा एकाच मजकुराला संदर्भानुसार वेगवेगळ्या भाषांतरांची आवश्यकता असते. अद्वितीय IDs देऊन आपण खात्री करता की त्या स्ट्रिंगच्या प्रत्येक उदाहरणाचे भाषांतर त्याच्या विशिष्ट अर्थानुसार अचूकपणे केले जाते.

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” असे स्पॅनिशमध्ये अनुवादित होऊ शकते.

सर्वोत्तम पद्धती