Matumizi ya hali ya juu
Kushughulikia lugha zinazosomeka kutoka kulia kwenda kushoto
TacoTranslate hufanya iwe rahisi kuunga mkono lugha zinazosomwa kutoka kulia kwenda kushoto (RTL), kama Kiarabu na Kiebrania, katika programu zako za React. Usimamizi mzuri wa lugha za RTL huhakikisha kwamba maudhui yako yanaonyeshwa kwa usahihi kwa watumiaji wasomao kutoka kulia kwenda kushoto.
import {useTacoTranslate} from 'tacotranslate/react';
function Document() {
const {locale, isRightToLeft} = useTacoTranslate();
return (
<html lang={locale} dir={isRightToLeft ? 'rtl' : 'ltr'}>
<body>
// ...
</body>
</html>
);
}
Unaweza pia kutumia kipengele cha isRightToLeftLocaleCode
kilichotolewa ili kuangalia lugha ya sasa nje ya React.
import {isRightToLeftLocaleCode} from 'tacotranslate';
function foo(locale = 'es') {
const direction = isRightToLeftLocaleCode(locale) ? 'rtl' : 'ltr';
// ...
}
Kuizima tafsiri
Ili kuzima tafsiri kwa sehemu maalum za mfuatano wa maandishi au kuhakikisha sehemu fulani zinahifadhiwa kama zilivyo, unaweza kutumia mabano matatu ya mraba triple square brackets. Kipengele hiki ni muhimu kwa kuhifadhi muundo wa asili wa majina, istilahi za kiufundi, au maudhui mengine yoyote ambayo hayapaswi kutafsiriwa.
import {Translate} from 'tacotranslate/react';
function Component() {
return (
<Translate string="Hello, [[[TacoTranslate]]]!" />
);
}
Katika mfano huu, neno “TacoTranslate” halitabadilika katika tafsiri.
Watoa huduma wengi wa TacoTranslate
Tunapendekeza kwa nguvu kutumia watoa huduma wengi wa TacoTranslate
katika programu yako. Hii ni muhimu kwa kupanga tafsiri na mistari yako katika makazi tofauti, kama vile kichwa, chini, au sehemu maalum.
Unaweza kusoma zaidi kuhusu kutumia mabeo hapa.
Watoa huduma za TacoTranslate
huchukua mipangilio kutoka kwa mtoa huduma wa mzazi, hivyo hutahitaji kurudia mipangilio mingine yoyote.
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>
);
}
Kupindua asili au eneo
Mbali na kutumia watoa huduma wengi wa TacoTranslate
, pia unaweza kubatilisha asili na eneo zote kwenye sehemu ya Translate
na ngazi za hook za useTranslation
.
import {Translate, useTranslation} from 'tacotranslate/react';
function Greeting() {
const spanishHello = useTranslation('Hello!', {locale: 'es'});
return (
<>
{spanishHello}
<Translate string="What’s up?" origin="greeting" />
</>
);
}
Kushughulikia upakiaji
Wakati wa kubadilisha lugha upande wa mteja, upokeaji wa tafsiri unaweza kuchukua muda mfupi kulingana na muunganisho wa mtumiaji. Unaweza kuonyesha kiashiria cha kupakia ili kuboresha uzoefu wa mtumiaji kwa kutoa maoni ya picha wakati wa kubadilisha.
import {useTacoTranslate} from 'tacotranslate/react';
function Component() {
const {isLoading} = useTacoTranslate();
return (
isLoading ? 'Translations are loading...' : null
);
}
Uwingi wa maneno
Ili kushughulikia umoja na kuonyesha lebo zinazoendana na hesabu kwa usahihi katika lugha tofauti, hii inachukuliwa kama mbinu bora:
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)}}
/>
);
}
Lugha nyingi
Ili kuunga mkono lugha nyingi kwa wakati mmoja ndani ya programu hiyo hiyo, unaweza kutumia wasambazaji wengi wa TacoTranslate wenye thamani tofauti za locale
kama inavyoonyeshwa hapa chini:
Unaweza pia kubadilisha locale
kwa ngazi ya sehemu au 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>
);
}
Kutumia vitambulisho vya tafsiri
Unaweza kuongeza id
kwenye sehemu ya Translate
ili kushughulikia tafsiri tofauti au maana za neno moja. Hii ni muhimu hasa wakati maandishi yale yale yanahitaji tafsiri tofauti kulingana na muktadha. Kwa kuteua vitambulisho maalum, unahakikisha kuwa kila mara neno hilo linasomwa kwa usahihi kulingana na maana yake maalum.
import {Translate} from 'tacotranslate/react';
function Header() {
return (
<Translate id="header" string="Login" />
);
}
function Footer() {
return (
<Translate id="footer" string="Login" />
);
}
Kwa mfano, kuingia kwa header inaweza kutafsiriwa kuwa “Iniciar sesión”, na kuingia kwa footer inaweza kutafsiriwa kuwa “Acceder” kwa Kihispania.