Takardun bayanai: Amfani na ci gaba

Amfani na ci gaba

Hausa

Sarrafa harsuna masu rubutu 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 ɗinku. Kyakkyawan sarrafa harsunan RTL yana tabbatar da cewa abubuwan cikin ku an nuna su 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 kuna iya amfani da aikin da aka bayar isRightToLeftLocaleCode don bincika yaren yanzu a wajen React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Kashe fassara

Don kashe fassara ga wasu sassa na rubutu ko don tabbatar da cewa wasu bangarori su kasance kamar yadda suke, za ku iya amfani da alamar murabba'i sau uku (triple square brackets). Wannan fasalin yana da amfani wajen kiyaye 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 misalin, kalmar "TacoTranslate" ba za a canza ta ba a cikin fassarar.

Masu ba da TacoTranslate da dama

Muna ƙarfafa sosai yin amfani da masu ba da TacoTranslate da yawa a cikin aikace-aikacenku. Wannan yana da amfani wajen tsara fassarorinku da rubutunku cikin asali daban-daban, kamar kanun shafi, ƙasan shafi, ko wasu sassa na musamman.

Za ku iya karanta ƙarin bayani game da yadda ake amfani da asali anan.

Masu samar da TacoTranslate suna gada saituna daga duk wani mai samar na uwa, 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 saitin yare

Bugu da ƙari ga amfani da masu samarwa TacoTranslate da yawa, za ku iya kuma canza duka origin da locale a matakan sashin Translate da kuma 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" />
		</>
	);
}

Gudanar da lodawa

Lokacin canza yare a gefen abokin ciniki, ɗaukar fassara na iya ɗaukar ƴan lokuta dangane da haɗin Intanet na mai amfani. Kuna iya nuna alamar lodawa don inganta kwarewar mai amfani ta hanyar ba da amsa ta gani yayin canjin.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Yin jam'i

Don magance batun jam'i da nuna lakabobin 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

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

Hakanan zaka iya maye gurbin locale a matakin sashi (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 IDs na fassara

Za ku iya ƙara id zuwa Translate komponent don sarrafa fassarori daban-daban ko ma'anonin daban ga rubutu ɗaya. Wannan na da matuƙar amfani musamman idan rubutu ɗaya yana buƙatar fassarori daban-daban bisa mahallin. Ta hanyar ba da ID na musamman, kuna tabbatar da cewa kowane misali na wannan rubutu an 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" />
	);
}

Alal misali, rubutun shiga na header zai iya fassaruwa zuwa “Iniciar sesión”, kuma rubutun shiga na footer zai iya fassaruwa zuwa “Acceder” a cikin Sifaniya.

Mafi kyawun hanyoyi