Skjöl: Bestu vinnubrögð

Bestu vinnubrögð

Icelandic

Settu vefslóðir í breytur

Þegar verið er að þýða strengi sem innihalda vefslóðir eða sambærileg gögn er talið góð vinnubrögð að setja þessar vefslóðir í breytur og vísa síðan í þær í sniðmátunum.

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

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

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

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

Eitthvað við þetta finnst mér mjög meta.

Alheimsfylki uppruna og margir upprunir íhluta

Þessi aðferð virkar aðeins þegar hún er notuð með Next.js Pages Router.

Þegar unnið er með stærri forrit er gagnlegt að skipta strengjum og þýðingum upp í fleiri, minni uppruna. Þessi aðferð dregur úr pakkastærðum og flutningstímum og tryggir skilvirka og skalanlega staðfærslu.

Þetta er einfalt þegar aðeins er renderað á viðskiptavinasíðunni, en stjórnun uppruna flækist fljótt þegar þýðingar eru sóttar fyrir þjónhliða rendering. Hins vegar geturðu sjálfvirkjað stjórnun uppruna með því að nota origins fylkið í TacoTranslate-viðskiptavininum.

Skoðaðu þetta dæmi, þar sem við höfum aðskilið íhluti og síður í 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});
}

Sjáðu dæmi um server-side rendering fyrir frekari upplýsingar um getTacoTranslateStaticProps.

Meðhöndlun villna og villuleit

Bestu vinnubrögð

Notaðu ARIA-merkingar

Alheimsfylki uppruna og margir upprunir íhluta