Itilizasyon avanse
Jere lang ki ekri adwat pou gòch
TacoTranslate fè li fasil pou sipòte lang ki ekri de dwat a goch (RTL), tankou Arab ak Ebre, nan aplikasyon React ou yo. Trete lang RTL yo kòrèkteman asire kontni ou parèt jan li dwe 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 itilize fonksyon isRightToLeftLocaleCode
yo 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 karaktè oswa pou asire sèten segman rete jan yo ye a, ou ka itilize twa parantèz kare. Fonksyon sa a itil pou kenbe fòma orijinal non yo, tèm teknik yo, 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 san chanjman nan tradiksyon an.
Plizyè founisè TacoTranslate
Nou ankouraje anpil pou w itilize plizyè TacoTranslate
founisè nan aplikasyon ou a. Sa itil pou òganize tradiksyon ou yo ak chenn karaktè 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 eritye paramèt ki soti nan nenpòt founisè paran, kidonk ou pap 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>
);
}
Ranplase orijin oswa lokal
Anplis de itilize plizyè TacoTranslate
founisè, ou ka tou ranplase tou de orijin ak locale sou nivo konpozan Translate
ak 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" />
</>
);
}
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 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 pluralizasyon epi montre etikèt ki baze sou kantite 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 ki montre anba a:
Ou ka tou ranplase locale
sou 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 diferan tradiksyon oswa sans pou menm tèks la. Sa a sitou itil lè menm tèks la bezwen diferan tradiksyon selon kontèks la. Lè ou bay ID inik, ou asire ke chak egzemplè tèks la tradui kòrèkteman 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, login nan header la ka tradui kòm “Iniciar sesión”, e login nan footer la ka tradui kòm “Acceder” an Panyòl.