Dokimantasyon: Itilizasyon avanse

Itilizasyon avanse

Haitian Creole

Jere lang ki ekri de adwat a agoch

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

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Ou kapab itilize tou 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';
	// ...
}

Dekonekte tradiksyon

Pou enfim tradiksyon pou pati espesifik nan yon chèn oswa pou asire kèk seksyon rete jan yo ye a, ou ka itilize triple espas kare. 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” p ap chanje nan tradiksyon an.

Plizyè founisè TacoTranslate

Nou ankouraje fò anpil pou itilize plizyè TacoTranslate founisè nan aplikasyon w lan. Sa itil pou òganize tradiksyon ou yo ak chenn karaktè ou 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 anviwònman ki soti nan nenpòt founisè paran, konsa ou p ap 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>
	);
}

Sipyasan orijin oswa lokal

Anplis de itilize plizyè TacoTranslate founisè, ou ka tou chanje tou de origin ak locale sou konpozan Translate ak nivo useTranslation hook yo.

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, rechèch tradiksyon yo ka pran kèk moman selon koneksyon itilizatè a. Ou ka montre yon endikatè chajman pou amelyore eksperyans itilizatè a lè w bay yon fidbak 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 kantite kòrèkteman nan diferan lang, sa konsidere kòm meyè 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.

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 lan. Sa a patikilyèman itil lè menm tèks la mande diferan tradiksyon selon kontèks la. Lè w asiyen ID inik, ou asire ke chak ensidan nan chenn lan 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, koneksyon tèt ka tradui kòm “Iniciar sesión”, e koneksyon anba ka tradui kòm “Acceder” an panyòl.

Pi bon pratik