Takardun bayani: Amfani na ci gaba

Amfani na ci gaba

Hausa

Sarrafa harsunan daga dama zuwa hagu

TacoTranslate yana saukaka tallafawa harsunan da ke daga dama zuwa hagu (RTL), kamar Larabci da Ibrananci, a cikin aikace-aikacen React ɗinku. Daidaitaccen sarrafa harsunan RTL yana tabbatar da cewa abun cikin ku ana nuna shi yadda ya kamata 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 ka iya amfani da aikin isRightToLeftLocaleCode da aka tanada don duba yaren yanzu a wajen React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Kashe fassara

Don hana fassara wasu sassa na wani rubutu ko don tabbatar da cewa wasu bangarori za su kasance kamar yadda suke, za ka iya amfani da alamomin baka murabba'i sau uku. Wannan fasalin yana da amfani wajen kiyaye tsarin asali na sunaye, kalmomin fasaha, ko duk wani abu da bai dace a fassara ba.

import {Translate} from 'tacotranslate/react';

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

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

Masu samar da TacoTranslate da dama

Muna ƙarfafawa sosai ku yi amfani da masu samar da TacoTranslate da yawa a cikin aikace-aikacenku. Wannan yana da amfani wajen tsara fassararku da rubutunku bisa ga asali daban-daban, kamar kan shafi, ƙasan shafi, ko sassa na musamman.

Kuna iya karanta ƙarin bayani game da yadda ake amfani da asali a nan.

TacoTranslate masu bayarwa suna gado saituna daga kowanne uwar mai bayarwa, 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 yanki

Baya ga amfani da masu samarwa da yawa na TacoTranslate, za ku iya kuma maye gurbin duka asali da saitin yare a matakan sashi na 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 lodawa

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

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Jam'i

Don kula da jam'i da kuma nuna lakabi bisa ga adadi yadda ya kamata 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 yawa

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

Hakanan za ku iya musanya 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 ID na fassara

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

import {Translate} from 'tacotranslate/react';

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

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

Misali, maɓallin shiga na kan shafi na iya fassaruwa zuwa “Iniciar sesión”, kuma maɓallin shiga na ƙasan shafi na iya fassaruwa zuwa “Acceder” a cikin Sifaniyanci.

Mafi kyawun hanyoyi