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 svipuð gögn er það talin góð venja að setja þessar vefslóðir í breytur og vísa svo í þær innan sniðmátanna.

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

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

Til dæmis, ef þú ert með hnapp sem leyfir notendum að afrita texta úr kóðablokki, 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 er mjög meta.

Alheimsfylki uppruna og margir upprunir íhluta

Þetta mynstur virkar aðeins við notkun 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});
}

Skoðaðu dæmi um þjónsíðubirtingu í dæmum um þjónsíðubirtingu til að fá frekari upplýsingar um getTacoTranslateStaticProps.

Villumeðhöndlun og bilanaleit

Bestu vinnubrögð

Notaðu ARIA-merkingar

Alheimsfylki uppruna og margir upprunir íhluta