Takardun bayani: Amfani mai zurfi

Amfani na ci gaba

Hausa

Sarrafa harsuna daga dama zuwa hagu

TacoTranslate yana sauƙaƙa tallafawa harsunan daga dama zuwa hagu (RTL), kamar Larabci da Ibrananci, a cikin aikace-aikacen React ɗinka. Kyakkyawan sarrafa harsunan RTL yana tabbatar da cewa abun ciki naka yana bayyana daidai ga masu amfani waɗanda 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 ka iya amfani da aikin isRightToLeftLocaleCode da aka bayar don duba harshen yanzu a wajen React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Kashe fassara

Don kashe fassara don wasu sassa na rubutu ko kuma don tabbatar da cewa wasu sassa sun kasance yadda suke, za ka iya amfani da ƙaramin murabba'in murabba'i uku triple square brackets. Wannan fasalin yana da amfani don kiyaye tsarin asali na sunaye, kalmomin fasaha, ko duk wani abun ciki da bai kamata a fassara ba.

import {Translate} from 'tacotranslate/react';

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

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

Masu samar da TacoTranslate da yawa

Muna ƙarfafawa sosai wajen amfani da masu bayar da sabis TacoTranslate da yawa a cikin aikace-aikacenku. Wannan yana da amfani don tsara fassarorinku da kuma rubuce-rubucenku zuwa asali daban-daban, kamar kai, ƙasa, ko sassa na musamman.

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

Masu samar da TacoTranslate suna gada saituna daga kowanne mai samar da uwar garken, don haka ba lallai ne ku maimaita wasu 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>
	);
}

Soke tushen ko yanki

Bayan amfani da masu bayarwa da yawa na TacoTranslate, za ka iya kuma sauya asalinsu da yaren da ake amfani da shi a matakan sassan Translate da kuma maƙalewar 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 ɗora bayanai

Lokacin canza harsuna a gefen abokin ciniki, karɓar fassara na iya ɗaukar ƴan lokuta gwargwadon haɗin yanar gizon mai amfani. Kuna iya nuna alamar loading don inganta ƙwarewar mai amfani ta hanyar samar da amsa ta gani yayin canjin.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Yawan jam'i

Don sarrafa jam'i da nuna alamomin bisa ga ƙidayar 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)}}
		/>
	);
}

Yawancin harsuna

Domin tallafawa harsuna da dama a lokaci guda cikin aikace-aikacen guda ɗaya, za ka iya amfani da masu ba da TacoTranslate da yawa tare da ƙimomin locale daban-daban kamar yadda aka nuna a ƙasa:

Hakanan za ka iya sauya locale a matakin ƙari ko matakin haɗawa.

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 ID ɗin fassara

Kuna iya ƙara id zuwa ga Translate ɓangaren domin sarrafa fassara daban-daban ko ma'anoni daban-daban ga wannan layi guda. Wannan yana da amfani musamman idan rubutun iri ɗaya yana buƙatar fassara daban-daban gwargwadon mahallin sa. Ta hanyar bai wa kowane ID na musamman, kuna tabbatar da cewa kowace fitowar wannan layin an fassara ta daidai gwargwadon ma'anar da ta dace.

import {Translate} from 'tacotranslate/react';

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

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

Alal misali, shiga na saman shafi na iya fassara zuwa “Iniciar sesión”, kuma shiga na ƙarshen shafi na iya fassara zuwa “Acceder” a cikin harshen Sifaniyanci.

Mafi kyawun hanyoyi