Skjölun: Bestu vinnubrögð

Bestu vinnubrögð

Icelandic

Settu slóðir í breytur

Þegar þýða á strengina sem innihalda URL-slóðir eða svipuð gögn, er talið góð venja að setja þessar URL-slóðir í breytur og vísa síðan í þær innan sniðmáta þinna.

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

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

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

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

Eitthvað við þetta finnst mjög meta.

Heildræn uppruna fylki og margir upprunar íhluta

Þessi aðferð virkar aðeins þegar notað er Next.js Pages Router.

When working with larger applications, it’s beneficial to split strings and translations into multiple, smaller origins. This approach helps decrease bundle sizes and transfer times, ensuring efficient and scalable localization.

While this is straightforward when rendering only on the client side, managing origins quickly becomes complex when fetching translations for server-side rendering. However, you can automate origin management by utilizing the TacoTranslate client origins array.

Hugleiddu þetta dæmi, þar sem við höfum aðskilið okkar íhluti og síður í sér skráa.

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 okkar dæmi um server-side rendering til að fá frekari upplýsingar um getTacoTranslateStaticProps.

Villumeðhöndlun og bilanaleit

Bestu vinnubrögð

Notaðu ARIA merkimiða

Heildræn uppruna fylki og margir upprunar íhluta