Dokimantasyon: Itilizasyon avanse

Itilizasyon avanse

Haitian Creole

Jere lang ki ekri soti adwat ale agoch

TacoTranslate fè li fasil pou sipòte lang ki li de dwat a goch (RTL), tankou Arab ak Ebre, nan aplikasyon React ou yo. Bon jesyon lang RTL asire kontni ou parèt kòrèkteman pou itilizatè ki li de dwat a goch.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Ou ka tou sèvi ak fonksyon isRightToLeftLocaleCode ki bay la pou tcheke lang aktyèl la deyò React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Dezaktive tradiksyon

Pou dezaktive tradiksyon pou pati espesifik nan yon chèn tèks oswa pou asire kèk segman rete menm jan an, ou ka itilize twa parantèz kare. Fonksyon sa a itil pou kenbe fòma orijinal non, tèm teknik, oswa nenpòt lòt kontni ki pa ta dwe tradui.

import {Translate} from 'tacotranslate/react';

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

Nan egzanp sa a, mo “TacoTranslate” la pral rete san chanjman nan tradiksyon an.

Plizyè founisè TacoTranslate

Nou ankouraje fò anpil pou w itilize plizyè founisè TacoTranslate nan aplikasyon w lan. Sa itil pou òganize tradiksyon ou yo ak chenn tèks yo nan diferan orijin, tankou tèt paj la, pye paj la, oswa seksyon espesifik.

Ou ka li plis sou fason pou itilize orijin yo isit la.

TacoTranslate founisè yo erite anviwònman yo sòti nan nenpòt founisè paran, kidonk ou p'ap bezwen repete lòt anviwònman yo.

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

Ranplase orijin oswa lokal

Anplis itilize plizyè TacoTranslate founisè, ou kapab tou ranplase tou de orijin ak lokal sou nivo konpozan Translate ak nivo 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" />
		</>
	);
}

Jere chajman

Lè w ap chanje lang sou bò kliyan an, chaje tradiksyon yo ka pran kèk moman selon koneksyon itilizatè a. Ou ka montre yon endikatè chajman pou amelyore eksperyans itilizatè a pa bay yon retou vizyèl pandan chanjman an.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Pliralizasyon

Pou jere fòm pliryèl yo epi montre etikèt ki baze sou kantite yo kòrèkteman nan diferan lang, sa konsidere kòm pi bon pratik:

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

Plizyè lang

Pou sipòte plizyè lang an menm tan nan menm aplikasyon an, ou ka itilize plizyè founisè TacoTranslate ak diferan valè locale jan sa montre anba a:

Ou ka tou ranplase locale nan nivo konpozan an oswa hook la.

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

Sèvi ak ID tradiksyon

Ou ka ajoute yon id nan konpozan Translate pou jere tradiksyon diferan oswa siyifikasyon diferan pou menm chèn nan. Sa itil espesyalman lè menm tèks la bezwen tradiksyon diferan selon kontèks la. Lè ou bay ID inik, ou asire ke chak aparisyon chèn nan tradui avèk presizyon selon siyifikasyon espesifik li.

import {Translate} from 'tacotranslate/react';

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

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

Pa egzanp, header login ta ka tradwi kòm “Iniciar sesión”, epi footer login ta ka tradwi kòm “Acceder” an panyòl.

Pi bon pratik