Takaddun bayanai: Amfani na ci gaba

Amfani na ci gaba

Hausa

Sarrafa harsunan daga dama zuwa hagu

TacoTranslate yana sauƙaƙa goyon bayan harsunan daga dama zuwa hagu (RTL), kamar Larabci da Ibrananci, a cikin aikace-aikacen React ɗinka. Sarrafa harsunan RTL yadda ya kamata yana tabbatar da cewa abun ciki ɗinka ana nuna shi daidai ga masu amfani da ke karantawa daga dama zuwa hagu.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Hakanan za ku iya amfani da aikin isRightToLeftLocaleCode da aka bayar don bincika yaren yanzu a wajen React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Kashe fassara

Don dakatar da fassara ga wasu sassa na rubutu ko don tabbatar da cewa wasu ɓangarori an kiyaye su yadda suke, za ku iya amfani da murabba'ai uku. Wannan fasalin yana amfani wajen kiyaye asalin tsarin sunaye, kalmomin fasaha, ko duk wani abu da bai kamata a fassara ba.

import {Translate} from 'tacotranslate/react';

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

A cikin wannan misali, kalmar “TacoTranslate” ba za a canza ta ba a fassarar.

Masu samar da TacoTranslate da yawa

Muna ƙarfafa sosai yin amfani da masu samar da TacoTranslate da yawa a cikin aikace-aikacenku. Wannan yana da amfani wajen tsara fassarorinku da rubutun ku cikin asalai daban-daban, kamar kan shafi (header), ƙasan shafi (footer), ko wasu takamaiman sassa.

Kuna iya karanta ƙarin bayani game da amfani da asali anan.

TacoTranslate masu samar suna gado saituna daga kowanne mahaifi, don haka ba za ku buƙaci maimaita sauran saituna ba.

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

Maye gurbin asali ko yare

Baya ga amfani da masu samarwa da yawa na TacoTranslate, kuna iya kuma maye gurbin asali da yare a matakan sashin Translate da matakan hook na useTranslation.

import {Translate, useTranslation} from 'tacotranslate/react';

function Greeting() {
	const spanishHello = useTranslation('Hello!', {locale: 'es'});

	return (
		<>
			{spanishHello}
			<Translate string="What’s up?" origin="greeting" />
		</>
	);
}

Sarrafa yanayin lodawa

Lokacin da ake canza harshe a bangaren abokin ciniki, samo fassarori na iya ɗaukar ƴan lokuta, gwargwadon haɗin intanet na mai amfani. Kuna iya nuna alamar lodi don inganta ƙwarewar mai amfani ta hanyar ba da martani na gani yayin wannan sauyi.

import {useTacoTranslate} from 'tacotranslate/react';

function Component() {
	const {isLoading} = useTacoTranslate();

	return (
		isLoading ? 'Translations are loading...' : null
	);
}

Yin jam'i

Don sarrafa jam'i da kuma nuna lakabi da suka danganci ƙididdiga daidai a cikin harsuna daban-daban, ana ɗaukar wannan a matsayin mafi kyawun aiki:

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

Harsuna da dama

Domin tallafawa harsuna da yawa a lokaci guda cikin wannan aikace-aikacen, za ku iya amfani da masu samar da TacoTranslate da yawa tare da ƙimomin locale daban-daban kamar yadda aka nuna a ƙasa:

Hakanan za ka iya maye gurbin locale a matakin sashi ko na hook.

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

Amfani da IDs na fassara

Kuna iya ƙara id a cikin sashin Translate don sarrafa fassarori ko ma'anonin daban-daban na wannan rubutu. Wannan na da amfani musamman idan rubutu ɗaya ke buƙatar fassarori daban-daban dangane da mahallinsa. Ta hanyar ba da IDs na musamman, za ku tabbatar da cewa kowace maimaitar wannan rubutu an fassara ta daidai gwargwadon ma'anarta.

import {Translate} from 'tacotranslate/react';

function Header() {
	return (
		<Translate id="header" string="Login" />
	);
}

function Footer() {
	return (
		<Translate id="footer" string="Login" />
	);
}

Alal misali, 'header login' zai iya fassaruwa zuwa “Iniciar sesión”, kuma 'footer login' zai iya fassaruwa zuwa “Acceder” a Sifaniyanci.

Mafi kyawun ayyuka