Dokimantasyon: Itilizasyon avanse

Itilizasyon avanse

Haitian Creole

Jere lang ki soti dwat pou ale agoch

TacoTranslate fè li fasil pou sipòte lang ki ale soti dwat pou goch (RTL), tankou Arab ak Ebre, nan aplikasyon React ou yo. Yon bon jere lang RTL asire ke kontni ou afiche kòrèkteman pou itilizatè ki li soti dwat pou 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 itilize tou 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 sèten segment yo rete jan yo ye a, ou ka itilize twa parantèz 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” ap rete menm jan nan tradiksyon an.

Plizyè founisè TacoTranslate

Nou ankouraje fò anpil pou itilize plizyè TacoTranslate founisè nan aplikasyon ou an. Sa itil pou òganize tradiksyon ak strings ou yo nan diferan orijin, tankou tèt paj ou, anba 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, kidonk 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>
	);
}

Sispann 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, rale 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 fidbak vizyèl pandan chanjman an.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Pliralizasyon

Pou jere pliryèlizasyon 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 avèk diferan valè locale jan sa montre anba a:

Ou kapab tou ranplase locale nan nivo konpozan oswa rale.

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 lan pou jere diferan tradiksyon oswa sans pou menm fisèl la. Sa a se patikilyèman itil lè menm tèks la mande pou tradiksyon diferan selon kontèks la. Lè ou asiyen ID inik, ou asire ke chak egzanp fisèl la tradwi avèk presizyon selon sans 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 ka tradui kòm “Iniciar sesión”, epi footer login ka tradui kòm “Acceder” an panyòl.

Pi bon pratik