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"
/>

В чём-то это ощущается очень мета.

Глобальный массив origins и несколько origins компонентов

Этот шаблон работает только при использовании 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Сделано в Норвегии