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

උසස් භාවිතය

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 සපයන්නන් භාවිතා කිරීමට දැඩි ලෙස නිර්දේශ කරමු. මෙය ඔබගේ පරිවර්තන සහ පෙළ (strings) විවිධ මූලාශ්‍රවලට — උදාහරණයක් ලෙස ශීර්ෂ කොටස, පාද කොටස හෝ විශේෂ කොටස් — සංවිධානය කිරීමට ප්‍රයෝජනවත් වේ.

ඔබට මෙතැනින් මූලාශ්‍ර භාවිතය පිළිබඳ වැඩිදුර කියවිය හැක.

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 හූක් මට්ටම්වලදී මූලාශ්‍රය සහ 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 කොම්පෝනන්ට් හෝ හුක් මට්ටමේදී ද වෙනස් කළ හැක.

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

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