Dokimantasyon: Itilizasyon avanse

Itilizasyon avanse

Haitian Creole

Jesyon lang ki ekri de dwat ale gòch

TacoTranslate fasilite sipòte lang ki li de dwat pou goch (RTL), tankou Arab ak Ebre, nan aplikasyon React ou yo. Yon bon jere lang RTL asire ke kontni ou a parèt kòrèkteman pou itilizatè ki li depi dwat pou ale goch.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Ou kapab sèvi tou ak fonksyon isRightToLeftLocaleCode ki bay la pou verifye 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 chenn oubyen pou asire sèten segman rete konsa jan yo ye a, ou ka itilize twa parantèz kare triple square brackets. Karakteristik sa a itil pou kenbe fòma orijinal non, tèm teknik, oswa nenpòt lòt kontni ki pa dwe tradui.

import {Translate} from 'tacotranslate/react';

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

Nan egzanp sa a, mo “TacoTranslate” pral rete menm jan an nan tradiksyon an.

Plizyè founisè TacoTranslate

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

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

Founisè TacoTranslate yo eritye anviwònman ki soti nan nenpòt founisè paran, konsa ou pap bezwen repete okenn lòt anviwònman.

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

Sòti nan orijin oswa lokal

Anplis de itilize plizyè TacoTranslate founisè, ou ka tou anile tou de orijin ak lokal sou nivo konpozan Translate ak gwo-ten useTranslation.

import {Translate, useTranslation} from 'tacotranslate/react';

function Greeting() {
	const spanishHello = useTranslation('Hello!', {locale: 'es'});

	return (
		<>
			{spanishHello}
			<Translate string="What’s up?" origin="greeting" />
		</>
	);
}

Jesyon chajman

Lè w ap chanje lang sou bò kliyan an, rekipere 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 repons vizyèl pandan chanjman an.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Pliryèlizasyon

Pou jere pliryèl ak montre etikèt ki baze sou konte 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 kapab tou ranplase locale nan nivo konpozan 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 diferan tradiksyon oswa siyifikasyon pou menm chenn karaktè a. Sa se espesyalman itil lè menm tèks la mande diferan tradiksyon selon kontèks la. Lè w asiyen ID inik, ou garanti ke chak egzanp chenn karaktè a 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, login nan header ka tradui kòm “Iniciar sesión”, epi login nan footer ka tradui kòm “Acceder” an Panyòl.

Pi bon pratik