ලේඛන: උසස් භාවිතය

උසස් භාවිතය

Sinhala

දකුණෙන් වමට කියවෙන භාෂා හසුරවීම

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

origin හෝ locale අතික්‍රමණය කිරීම

බහු TacoTranslate සපයන්නන් භාවිත කිරීමට අමතරව, Translate කොම්පොනන්ට් සහ useTranslation හුක් මට්ටම්වලදී origin සහ locale යන දෙකම ඔබට override කළ හැක.

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 override කළ හැක.

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 සංරචකයට එක් කර එකම පෙළ සඳහා වෙනස් පරිවර්තන හෝ අර්ථ කළමනාකරණය කළ හැක. සන්දර්භය අනුව එකම පෙළට විවිධ පරිවර්තන අවශ්‍ය වන විට මෙය විශේෂයෙන් ප්‍රයෝජනවත් වේ. අද්විතීය හැඳුනුම් පැවරීමෙන්, සෑම අවස්ථාවකම පණිවිඩයේ අදාළ අර්ථයට අනුව නිවැරදිව පරිවර්තනය වීමට ඔබට සහතිකයක් ලැබේ.

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” ලෙස ස්පාඤ්ඤ භාෂාවට පරිවර්තනය විය හැක.

හොඳ ක්‍රියා පටිපාටි