Penggunaan lanjutan
Mengendalikan bahasa dari kanan ke kiri
TacoTranslate memudahkan sokongan untuk bahasa dari kanan ke kiri (RTL), seperti Bahasa Arab dan Ibrani, dalam aplikasi React anda. Pengendalian bahasa RTL yang betul memastikan kandungan anda dipaparkan dengan tepat untuk pengguna yang membaca dari kanan ke kiri.
import {useTacoTranslate} from 'tacotranslate/react';
function Document() {
const {locale, isRightToLeft} = useTacoTranslate();
return (
<html lang={locale} dir={isRightToLeft ? 'rtl' : 'ltr'}>
<body>
// ...
</body>
</html>
);
}
Anda juga boleh menggunakan fungsi isRightToLeftLocaleCode
yang disediakan untuk memeriksa bahasa semasa di luar React.
import {isRightToLeftLocaleCode} from 'tacotranslate';
function foo(locale = 'es') {
const direction = isRightToLeftLocaleCode(locale) ? 'rtl' : 'ltr';
// ...
}
Melumpuhkan terjemahan
Untuk menyahaktifkan terjemahan bagi bahagian tertentu dalam satu rentetan atau untuk memastikan segmen tertentu dikekalkan seperti asal, anda boleh menggunakan tiga kurungan kotak. Ciri ini berguna untuk mengekalkan format asal nama, istilah teknikal, atau sebarang kandungan lain yang tidak perlu diterjemah.
import {Translate} from 'tacotranslate/react';
function Component() {
return (
<Translate string="Hello, [[[TacoTranslate]]]!" />
);
}
Dalam contoh ini, perkataan “TacoTranslate” akan kekal tidak berubah dalam terjemahan.
Pelbagai penyedia TacoTranslate
Kami sangat menggalakkan penggunaan pelbagai penyedia TacoTranslate
dalam aplikasi anda. Ini berguna untuk mengatur terjemahan dan rentetan anda ke dalam asal yang berbeza, seperti pengepala, pengaki, atau bahagian tertentu.
Anda boleh baca lebih lanjut mengenai penggunaan origins di sini.
Penyedia TacoTranslate
mewarisi tetapan daripada mana-mana penyedia induk, jadi anda tidak perlu mengulangi sebarang tetapan lain.
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>
);
}
Menimpa origin atau locale
Selain menggunakan pelbagai penyedia TacoTranslate
, anda juga boleh menulis ganti kedua-dua origin dan locale pada komponen Translate
dan tahap 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" />
</>
);
}
Mengendalikan pemuatan
Apabila menukar bahasa di sisi pelanggan, mendapatkan terjemahan mungkin mengambil masa beberapa saat bergantung pada sambungan pengguna. Anda boleh memaparkan penunjuk pemuatan untuk meningkatkan pengalaman pengguna dengan memberikan maklum balas visual semasa pertukaran tersebut.
import {useTacoTranslate} from 'tacotranslate/react';
function Component() {
const {isLoading} = useTacoTranslate();
return (
isLoading ? 'Translations are loading...' : null
);
}
Pluralisasi
Untuk mengendalikan pluralisasi dan memaparkan label berdasarkan kiraan dengan betul dalam pelbagai bahasa, ini dianggap amalan terbaik:
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)}}
/>
);
}
Pelbagai bahasa
Untuk menyokong pelbagai bahasa serentak dalam aplikasi yang sama, anda boleh menggunakan beberapa penyedia TacoTranslate dengan nilai locale
yang berbeza seperti yang ditunjukkan di bawah:
Anda juga boleh menampal ganti locale
pada tahap komponen atau 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>
);
}
Menggunakan ID terjemahan
Anda boleh menambah id
kepada komponen Translate
untuk mengendalikan terjemahan atau makna yang berbeza bagi string yang sama. Ini sangat berguna apabila teks yang sama memerlukan terjemahan yang berbeza berdasarkan konteks. Dengan memberikan ID unik, anda memastikan setiap contoh string diterjemahkan dengan tepat mengikut makna khususnya.
import {Translate} from 'tacotranslate/react';
function Header() {
return (
<Translate id="header" string="Login" />
);
}
function Footer() {
return (
<Translate id="footer" string="Login" />
);
}
Sebagai contoh, login header mungkin diterjemahkan kepada “Iniciar sesión”, dan login footer mungkin diterjemahkan kepada “Acceder” dalam bahasa Sepanyol.