Skjöl: Bestu vinnubrögð

Góðar vinnubrögð

Icelandic

Settu vefslóðir í breytur

Þegar þýtt er strengjum sem innihalda vefslóðir eða svipuð gögn er gott að setja þessar vefslóðir í breytur og vísa síðan í þær innan sniðmátanna.

<Translate
	string={`Click <a href="{{url}}">here</a>`}
	variables={{url: 'https://tacotranslate.com'}}
/>

Þegar verið er að þýða texta gagnvirkra þátta, svo sem hnappa, er mikilvægt að bæta við ARIA-merkingum til að tryggja aðgengi. ARIA-merkingar hjálpa skjálesurum að veita lýsandi upplýsingar um virkni þáttarins.

Til dæmis, ef þú átt hnapp sem gerir notendum kleift að afrita texta úr kóðablokk, getur þú notað aria-label eiginleikann til að gefa skýra lýsingu:

<Translate
	aria-label={useTranslation('Copy to clipboard')}
	string="Copy"
/>

Mér finnst eitthvað við þetta vera mjög 'meta'.

Alheims upprunafylki og margir upprunir íhluta

Þetta mynstur virkar aðeins þegar notað er Next.js Pages Router.

Þegar unnið er með stærri forrit er gagnlegt að skipta strengjum og þýðingum upp í fleiri, minni upprunir. Þessi nálgun hjálpar til við að minnka stærð pakkanna og flutningstíma, sem tryggir skilvirka og stigstærða staðfærsla.

Þetta er einfalt þegar einungis er renderað á viðskiptavinshlið, en stjórnun uppruna verður fljótt flókin þegar þýðingar eru sóttar fyrir þjónahliðarrenderun. Hins vegar getur þú sjálfvirknað stjórnun uppruna með því að nota origins fylkið í TacoTranslate-viðskiptavininum.

Skoðaðu þetta dæmi, þar sem við höfum skipt íhlutum og síðum upp í aðskildar skrár.

components/pricing-table.tsx

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>
	);
}

pages/pricing.tsx

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});
}

Skoðaðu dæmi um server-side rendering í skjölum okkar til að fá frekari upplýsingar um getTacoTranslateStaticProps.

Villusýning og bilanaleit

Góðar vinnubrögð

Notaðu ARIA-merkingar

Alheims upprunafylki og margir upprunir íhluta