TacoTranslate
/
ДокументацияЦенообразуване
 
  1. Въведение
  2. Първи стъпки
  3. Настройка и конфигурация
  4. Използване на TacoTranslate
  5. Рендиране от страна на сървъра
  6. Разширено използване
  7. Добри практики
  8. Обработка на грешки и отстраняване на грешки
  9. Поддържани езици

Добри практики

Поставяйте URL-адресите в променливи

Когато превеждате низове, които съдържат URL адреси или подобни данни, смята се за добра практика да поставяте тези URL адреси в променливи и след това да ги използвате в шаблоните си.

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

Използвайте ARIA етикети

Когато превеждате текста на интерактивни елементи като бутони, е важно да включите ARIA етикети, за да осигурите достъпност. ARIA етикетите помагат на четеците на екрана да предоставят описателна информация за функцията на елемента.

Например, ако имате бутон, който позволява на потребителите да копират текст от блок с код, можете да използвате атрибута aria-label за да предоставите ясно описание:

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

Нещо в това звучи много мета.

Глобален масив с произходи и множество произходи за компоненти

Този подход работи само при използване на Next.js Pages Router.

Когато работите с по-големи приложения, е полезно да разделяте низовете и преводите на няколко по-малки източника. Този подход помага да се намалят размерите на пакетите и времето за пренос, осигурявайки ефективна и мащабируема локализация.

Докато това е лесно при рендиране само на клиентската страна, управлението на източниците бързо става сложно при извличане на преводи за рендиране от страна на сървъра. Въпреки това, можете да автоматизирате управлението на източниците, като използвате масива origins в клиента TacoTranslate.

Разгледайте този пример, в който сме разделили нашите компоненти и страници в отделни файлове.

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.

Обработка на грешки и отстраняване на грешки

Продукт от NattskiftetПроизведено в Норвегия