Labākā prakse
Ievietojiet URL adreses mainīgajos
Tulkojot virknes, kas satur URL vai tamlīdzīgus datus, par labu praksi tiek uzskatīts šos URL ievietot mainīgajos un pēc tam atsaukties uz tiem savās veidnēs.
<Translate
string={`Click <a href="{{url}}">here</a>`}
variables={{url: 'https://tacotranslate.com'}}
/>Izmantojiet ARIA etiķetes
Tulkodami interaktīvo elementu, piemēram, pogu, tekstu, ir svarīgi iekļaut ARIA etiķetes, lai nodrošinātu pieejamību. ARIA etiķetes palīdz ekrāna lasītājiem sniegt aprakstošu informāciju par elementa funkciju.
Piemēram, ja jums ir poga, kas ļauj lietotājiem nokopēt tekstu no koda bloka, varat izmantot aria-label atribūtu, lai sniegtu skaidru aprakstu:
<Translate
aria-label={useTranslation('Copy to clipboard')}
string="Copy"
/>Kaut kas šajā šķiet ļoti meta.
Globālais origins masīvs un vairāki komponentu origini
Šis paraugs darbojas tikai, ja tiek izmantots Next.js Pages Router.
Strādājot ar lielākām lietotnēm, ir izdevīgi sadalīt teksta virknes un tulkojumus vairākos, mazākos avotos. Šāda pieeja palīdz samazināt pakotņu izmērus un pārsūtīšanas laikus, nodrošinot efektīvu un mērogojamu lokalizāciju.
Kaut arī tas ir vienkārši, ja renderēšana notiek tikai klienta pusē, avotu pārvaldība ātri kļūst sarežģīta, kad tulkojumus jāiegūst servera puses renderēšanai. Tomēr varat automatizēt avotu pārvaldību, izmantojot TacoTranslate klienta origins masīvu.
Apsveriet šo piemēru, kur esam sadalījuši mūsu komponentus un lapas atsevišķos failos.
import TacoTranslate, {Translate} from 'tacotranslate/react';
import tacoTranslate from '../tacotranslate-client';
// Set an origin name for this component
const origin = 'components/pricing-table';
// Push the origin into the origins array as this file is imported
tacoTranslate.origins.push(origin);
export default function PricingTable() {
return (
<TacoTranslate origin={origin}>
<Translate string="Pricing table" />
// ...
</TacoTranslate>
);
}import TacoTranslate, {Translate} from 'tacotranslate/react';
import getTacoTranslateStaticProps from 'tacotranslate/next/get-static-props';
import tacoTranslateClient from '../tacotranslate-client';
import PricingTable from '../components/pricing-table';
const origin = 'pages/pricing';
tacoTranslateClient.origins.push(origin);
export default function PricingPage() {
return (
<TacoTranslate origin={origin}>
<Translate string="Pricing page" />
<PricingTable />
</TacoTranslate>
);
}
// We will now fetch translations for all imported components and their origins automatically
export async function getStaticProps(context) {
return getTacoTranslateStaticProps(context, {client: tacoTranslateClient});
}Skatiet mūsu servera puses renderēšanas piemērus, lai uzzinātu vairāk par getTacoTranslateStaticProps.