Dokimantasyon: Itilizasyon avanse

Itilizasyon avanse

Haitian Creole

Jere lang ki ekri soti dwat ale goch

TacoTranslate fè li fasil pou sipòte lang ki ale soti adwat a goch (RTL), tankou Arab ak Ebre, nan aplikasyon React ou yo. Bon jere lang RTL asire ke kontni ou parèt kòrèkteman pou itilizatè ki li soti adwat 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 kapab tou sèvi ak fonksyon isRightToLeftLocaleCode ki disponib 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 chèn oswa pou asire kèk segman yo konsève jan yo ye a, ou ka itilize triplye akwòch kare. Fonksyon 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” p ap chanje nan tradiksyon an.

Plizyè founisè TacoTranslate

Nou ankouraje fò anpil sèvi ak plizyè TacoTranslate founisè nan aplikasyon ou an. Sa itil pou òganize tradiksyon ou yo ak fisèl yo nan diferan orijin, tankou tèt paj ou, pye paj ou, oswa seksyon espesifik.

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

Founisè TacoTranslate yo eritye paramèt yo soti nan nenpòt founisè paran, konsa ou p’ap bezwen repete okenn lòt paramèt.

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

Sove orijin oubyen lokal

Anplis itilize plizyè TacoTranslate founisè, ou ka tou ranplase tou de orijin ak lokal sou konpozan Translate ak nivo kout 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, 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 chanje locale nan nivo konpozan oswa nivo 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>
	);
}

Sèvi ak ID tradiksyon

Ou ka ajoute yon id nan konpozan Translate pou jere diferan tradiksyon oswa siyifikasyon pou menm chenn nan. Sa a se patikilyèman itil lè menm tèks la bezwen diferan tradiksyon selon kontèks la. Lè w bay ID inik, ou asire chak egzanp chenn nan tradui avèk presizyon dapre 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, koneksyon nan tèt paj la ka tradui kòm “Iniciar sesión”, epi koneksyon nan pye paj la ka tradui kòm “Acceder” an panyòl.

Pi bon pratik