Hujjatlar: Eng yaxshi amaliyotlar

Eng yaxshi amaliyotlar

Uzbek

URL manzillarini o'zgaruvchilarga joylashtiring

URL manzillari yoki shunga o‘xshash ma’lumotlarni o‘z ichiga olgan satrlarni tarjima qilayotganda, bu URL manzillarini o‘zgaruvchilarga joylab, keyin ularni shablonlaringizda ishlatish yaxshi amaliyot hisoblanadi.

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

ARIA yorliqlaridan foydalaning

Tugmalar kabi interaktiv elementlarning matnini tarjima qilayotganda, kirish imkoniyatini ta'minlash uchun ARIA yorliqlarini qo'shish muhimdir. ARIA yorliqlari ekran o'qiydigan dasturlarga elementning vazifasi haqida tavsiflovchi ma'lumot berishda yordam beradi.

Masalan, agar sizda foydalanuvchilarga kod blokidan matnni nusxalash imkonini beruvchi tugma bo'lsa, aniq tasvir berish uchun aria-label atributidan foydalanishingiz mumkin:

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

Bunda nimadir juda meta kabi tuyuladi.

Global manbalar massivi va komponentlarning bir nechta manbalari

Ushbu naqsh faqat Next.js Pages Router ishlatilganda ishlaydi.

Katta ilovalar bilan ishlaganda, satrlarni va tarjimalarni bir nechta, kichikroq manbalarga bo'lish foydali. Bu yondashuv paket hajmini va uzatish vaqtlarini kamaytirishga yordam beradi, samarali va kengaytiriladigan lokalizatsiyani ta'minlaydi.

Bu faqat mijoz tomonida render qilganda oddiyroq bo'lsa-da, server tomonida render qilish uchun tarjimalarni olishda manbalarni boshqarish tezda murakkablashadi. Biroq, TacoTranslate klientidagi origins massividan foydalanib manbalarni boshqarishni avtomatlashtirishingiz mumkin.

Quyidagi misolni ko'rib chiqing, unda biz komponentlarimiz va sahifalarimizni alohida fayllarga ajratganmiz.

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

getTacoTranslateStaticProps> haqida qo'shimcha ma'lumot olish uchun bizning server tomonida render qilish misollarimizga qarang.

Xatolarni boshqarish va nosozliklarni tuzatish