Takardun Bayani: Amfani na Ci Gaba

Amfani na ci gaba

Hausa

Kulawa da harsunan da ake rubuta daga dama zuwa hagu

TacoTranslate yana sauƙaƙa wa aikace-aikacen React ɗinku tallafawa harsunan da ake karantawa daga dama zuwa hagu (RTL), kamar Larabci da Ibrananci. Sarrafa waɗannan harsunan yadda ya kamata yana tabbatar da cewa abun cikin ku 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>
	);
}

Kuna kuma iya amfani da aikin da aka bayar isRightToLeftLocaleCode don duba yaren yanzu a wajen React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Dakatar da fassara

Don dakatar da fassara ga wasu sassa na rubutu ko don tabbatar da cewa wasu sassa su kasance kamar yadda suke, za ka iya amfani da alamar baka murabba'i sau uku. Wannan fasalin yana da amfani wajen adana tsarin asali na sunaye, sharuɗɗan 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 cikin fassarar.

Masu ba da TacoTranslate da yawa

Muna ƙarfafa sosai yin amfani da masu samar da TacoTranslate da yawa a cikin aikace-aikacen ku. Wannan yana da amfani wajen tsara fassarori da rubutunku cikin tushe daban-daban, kamar saman shafi (header), ƙasan shafi (footer), ko wasu sassa na musamman.

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

TacoTranslate masu ba da sabis suna gado saituna daga kowanne mahaifi mai ba da sabis, 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 tushen ko saitin yare

Bugu da ƙari ga amfani da masu samar da TacoTranslate da yawa, za ka kuma iya maye gurbinsa ta hanyar maye gurbin asali da yare a matakin sashin Translate da matakin hook 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 lodawa

Lokacin da ake canza harsuna a bangaren abokin ciniki, samun fassarori na iya ɗaukar 'yan lokuta dangane da haɗin intanet na mai amfani. Kuna iya nuna alamar lodawa don inganta kwarewar mai amfani ta hanyar ba da martani na gani yayin sauyin.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Jam'i

Don sarrafa jam'i da nuna lakabi na ƙididdiga cikin harsuna daban-daban yadda ya dace, 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 yawa

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

Hakanan za ku iya maye gurbin locale a matakin component ko 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 ID ɗin fassara

Kuna iya ƙara id zuwa sashin Translate don sarrafa fassarori ko ma'anoni daban-daban na wannan rubutu ɗaya. Wannan yana da matuƙar amfani idan wannan rubutu ɗaya yana buƙatar fassarori daban-daban bisa ga mahallinsa. Ta hanyar ba da IDs na musamman, kuna tabbatar da cewa kowane misali na wannan rubutu ana fassara shi daidai gwargwadon ma'anarsa.

import {Translate} from 'tacotranslate/react';

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

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

Misali, kalmar shiga a cikin header na iya fassaruwa zuwa “Iniciar sesión”, kuma kalmar shiga a cikin footer na iya fassaruwa zuwa “Acceder” a cikin Sifaniyanci.

Mafi kyawun ayyuka