Labākās prakses
Ievieto URL mainīgajos
Tulkodami virknes, kas satur URL vai līdzīgus datus, tiek uzskatīts par labu praksi šos URL ievietot mainīgajos un pēc tam atsaukties uz tiem savos šablonos.
<Translate
string={`Click <a href="{{url}}">here</a>`}
variables={{url: 'https://tacotranslate.com'}}
/>
Izmantojiet ARIA etiķetes
Tulkodami interaktīvu 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 kopēt tekstu no koda bloka, varat izmantot aria-label
atribūtu, lai nodrošinātu skaidru aprakstu:
<Translate
aria-label={useTranslation('Copy to clipboard')}
string="Copy"
/>
Kaut kas šajā šķiet ļoti meta.
Globālais izcelsmes masīvs un vairāku komponentu izcelsmes
Šis modelis darbojas tikai, izmantojot Next.js Pages Router.
Strādājot ar lielākām lietojumprogrammām, ir izdevīgi sadalīt virknes un tulkojumus vairākos, mazākos avotos. Šī pieeja palīdz samazināt pakešu lielumu un pārsūtīšanas laiku, nodrošinot efektīvu un mērogojamu lokalizāciju.
Kaut arī tas ir vienkārši, ja renderē tikai klienta pusē, avotu pārvaldība ātri kļūst sarežģīta, kad tulkojumus iegūst servera puses renderēšanai. Tomēr avotu pārvaldību var automatizēt, izmantojot TacoTranslate klienta origins
masīvu.
Ņemiet vērā šo piemēru, kur mēs esam izdalī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 iegūtu vairāk informācijas par getTacoTranslateStaticProps
.