Получайте уведомления о предстоящих релизах Intlayer
    Создание:2024-08-14Последнее обновление:2025-08-20

    Почему стоит рассмотреть Intlayer?

    Что такое Intlayer?

    Intlayer - это библиотека интернационализации, разработанная специально для JavaScript-разработчиков. Она позволяет объявлять ваш контент в любом месте вашего кода. Она преобразует объявления многоязычного контента в структурированные словари для легкой интеграции в ваш код. Используя TypeScript, Intlayer делает вашу разработку более надежной и эффективной.

    Почему был создан Intlayer?

    Intlayer был создан для решения общей проблемы, которая затрагивает все популярные библиотеки i18n, такие как next-intl, react-i18next, react-intl, next-i18next, react-intl и vue-i18n.

    Все эти решения используют централизованный подход для перечисления и управления вашим контентом. Например:

    bash
    .├── locales│   ├── en.json│   ├── fr.json│   └── es.json├── i18n.ts└── src    └── components        └── MyComponent            └── index.tsx

    Или здесь с использованием пространств имён:

    bash
    .├── locales│   ├── en│   │  ├── footer.json│   │  └── navbar.json│   ├── fr│   │  ├── footer.json│   │  └── navbar.json│   └── es│      ├── footer.json│      └── navbar.json├── i18n.ts└── src    └── components        └── MyComponent            └── index.tsx

    Такой тип архитектуры замедляет процесс разработки и усложняет поддержку кода по нескольким причинам:

    1. Для каждого нового созданного компонента необходимо:

      • Создать новый ресурс/пространство имён в папке locales
      • Не забыть импортировать новое пространство имён на вашей странице
      • Перевести ваш контент (часто выполняется вручную путём копирования/вставки из AI-сервисов)
    2. Для любых изменений в ваших компонентах необходимо:

      • Найти соответствующий ресурс/пространство имён (которое находится далеко от компонента)
      • Перевести ваш контент
      • Убедиться, что ваш контент актуален для всех локалей
      • Проверить, что в вашем пространстве имён нет неиспользуемых ключей/значений
      • Убедиться, что структура ваших JSON-файлов одинакова для всех локалей

    В профессиональных проектах, использующих эти решения, часто применяются платформы локализации для управления переводом вашего контента. Однако для крупных проектов это может быстро стать дорогостоящим.

    Для решения этой проблемы Intlayer использует подход, при котором контент ограничивается областью компонента и хранится рядом с вашим компонентом, как это часто делается с CSS (styled-components), типами, документацией (storybook) или модульными тестами (jest).

    bash
    .└── components    └── MyComponent        ├── index.content.ts        ├── index.test.tsx        ├── index.stories.tsx        └── index.tsx
    ./components/MyComponent/index.content.ts
    import { t, type Dictionary } from "intlayer";const componentExampleContent = {  key: "component-example",  content: {    myTranslatedContent: t({      en: "Hello World",      es: "Hola Mundo",      fr: "Bonjour le monde",    }),  },} satisfies Dictionary;// Экспортируем контент компонента по умолчаниюexport default componentExampleContent;
    ./components/MyComponent/index.tsx
    import { useIntlayer } from "react-intlayer";export const ComponentExample = () => {  const { myTranslatedContent } = useIntlayer("component-example");  return <span>{myTranslatedContent}</span>;};

    Этот подход позволяет вам:

    1. Увеличить скорость разработки

      • Файлы .content.{{ts|mjs|cjs|json}} можно создавать с помощью расширения для VSCode
      • Инструменты автозаполнения на базе ИИ в вашей IDE (например, GitHub Copilot) могут помочь вам объявлять ваш контент, уменьшая необходимость копирования/вставки
    2. Очистить вашу кодовую базу

      • Снизить сложность
      • Повысить поддерживаемость
    3. Проще дублировать ваши компоненты и связанный с ними контент (например: компоненты входа/регистрации и т.д.)

      • Ограничивая риск влияния на контент других компонентов
      • Копируя и вставляя ваш контент из одного приложения в другое без внешних зависимостей
    4. Избегать загрязнения кодовой базы неиспользуемыми ключами/значениями для неиспользуемых компонентов

      • Если вы не используете компонент, Intlayer не будет импортировать его связанный контент
      • Если вы удаляете компонент, вам будет проще не забыть удалить связанный с ним контент, так как он будет находиться в той же папке
    5. Снизить затраты на размышления для ИИ-агентов при объявлении вашего многоязычного контента

      • ИИ-агенту не нужно сканировать всю вашу кодовую базу, чтобы понять, где реализовать ваш контент
      • Переводы легко выполняются с помощью инструментов автозаполнения на базе ИИ в вашей IDE (например, GitHub Copilot)

    Дополнительные возможности Intlayer

    Функция Описание
    Feature Поддержка нескольких фреймворков

    Intlayer совместим со всеми основными фреймворками и библиотеками, включая Next.js, React, Vite, Vue.js, Nuxt, Preact, Express и другие.
    Feature Управление контентом на основе JavaScript

    Используйте гибкость JavaScript для эффективного определения и управления вашим контентом.

    - Объявление контента
    Feature Файл объявления контента для каждого локалитета

    Ускорьте разработку, объявляя ваш контент один раз, до автоматической генерации.

    - Файл объявления контента для каждого локалитета
    Feature Типобезопасная среда

    Используйте TypeScript, чтобы гарантировать отсутствие ошибок в определениях контента и коде, а также получать преимущества автозаполнения в IDE.

    - Настройка TypeScript
    Feature Упрощённая настройка

    Быстрый старт с минимальной конфигурацией. Легко настраивайте параметры интернационализации, маршрутизации, ИИ, сборки и обработки контента.

    - Изучите интеграцию с Next.js
    Feature Упрощённый доступ к контенту

    Нет необходимости вызывать функцию t для каждого элемента контента. Получайте весь ваш контент напрямую с помощью одного хука.

    - Интеграция с React
    Feature Единообразная реализация серверных компонентов

    Идеально подходит для серверных компонентов Next.js, используйте одну и ту же реализацию как для клиентских, так и для серверных компонентов, нет необходимости передавать функцию t через каждый серверный компонент.

    - Серверные компоненты
    Feature Организованная кодовая база

    Поддерживайте вашу кодовую базу более организованной: 1 компонент = 1 словарь в той же папке. Переводы, расположенные рядом с соответствующими компонентами, повышают удобство сопровождения и ясность.

    - Как работает Intlayer
    Feature Расширенная маршрутизация

    Полная поддержка маршрутизации приложений, плавно адаптирующаяся к сложным структурам приложений для Next.js, React, Vite, Vue.js и других.

    - Изучите интеграцию с Next.js
    Feature Поддержка Markdown

    Импортируйте и интерпретируйте локализационные файлы и удалённый Markdown для многоязычного контента, такого как политики конфиденциальности, документация и др. Интерпретируйте и делайте метаданные Markdown доступными в вашем коде.

    - Файлы контента
    Feature Бесплатный визуальный редактор и CMS

    Для авторов контента доступен бесплатный визуальный редактор и CMS, что устраняет необходимость в платформе локализации. Сохраняйте синхронизацию контента с помощью Git или полностью/частично внешне управляйте им через CMS.

    - Редактор Intlayer
    - CMS Intlayer
    Feature Контент с поддержкой tree-shaking

    Контент с поддержкой tree-shaking, уменьшающий размер итогового бандла. Загружает контент по компонентам, исключая неиспользуемый контент из вашего бандла. Поддерживает ленивую загрузку для повышения эффективности загрузки приложения.

    - Оптимизация сборки приложения
    Feature Статическая отрисовка

    Не блокирует статическую отрисовку.

    - Интеграция с Next.js
    Feature Перевод с использованием ИИ

    Преобразуйте ваш сайт на 231 язык всего одним кликом с помощью продвинутых инструментов перевода на базе ИИ от Intlayer, используя вашего собственного поставщика ИИ/ключ API.

    - Интеграция CI/CD
    - CLI Intlayer
    - Автозаполнение
    Feature Интеграция сервера MCP

    Обеспечивает сервер MCP (Model Context Protocol) для автоматизации IDE, позволяя бесшовно управлять контентом и процессами интернационализации (i18n) непосредственно в вашей среде разработки.

    - Сервер MCP
    Функция Расширение VSCode

    Intlayer предоставляет расширение для VSCode, которое поможет вам управлять вашим контентом и переводами, создавать словари, переводить ваш контент и многое другое.

    - Расширение VSCode
    Feature Взаимодействие

    Обеспечивает взаимодействие с react-i18next, next-i18next, next-intl и react-intl.

    - Intlayer и react-intl
    - Intlayer и next-intl
    - Intlayer и next-i18next

    Сравнение Intlayer с другими решениями

    Функция Intlayer React-i18next / i18next React-Intl (FormatJS) LinguiJS next-intl next-i18next vue-i18n
    Переводы рядом с компонентами Да, контент расположен рядом с каждым компонентом Нет Нет Нет Нет Нет Да - с использованием Single File Components (SFCs)
    Интеграция с TypeScript Продвинутая, автоматически сгенерированные строгие типы Базовая; дополнительная конфигурация для безопасности Хорошая, но менее строгая Типы, требуется конфигурация Хорошая Базовая Хорошая (типы доступны; требуется настройка безопасности ключей)
    Обнаружение отсутствующих переводов Ошибка/предупреждение во время сборки В основном строки-заменители во время выполнения Строки-заменители Требуется дополнительная настройка Строки-заменители во время выполнения Строки-заменители во время выполнения Строки-заменители/предупреждения во время выполнения (настраиваемо)
    Обогащённый контент (JSX/Markdown/компоненты) Прямая поддержка, включая React-узлы Ограничено / только интерполяция Синтаксис ICU, не настоящий JSX Ограничено Не предназначено для сложных узлов Ограничено Ограничено (компоненты через <i18n-t>, Markdown через плагины)
    Перевод с использованием ИИ Да, поддерживает нескольких поставщиков ИИ. Можно использовать с собственными API-ключами. Учитывает контекст вашего приложения и объем контента Нет Нет Нет Нет Нет Нет
    Визуальный редактор Да, локальный визуальный редактор + опциональная CMS; может вынести содержимое кодовой базы; встраиваемый Нет / доступно через внешние платформы локализации Нет / доступно через внешние платформы локализации Нет / доступно через внешние платформы локализации Нет / доступно через внешние платформы локализации Нет / доступно через внешние платформы локализации Нет / доступно через внешние платформы локализации
    Локализованная маршрутизация Встроенная, поддержка middleware Плагины или ручная настройка Не встроена Плагин/ручная настройка Встроена Встроена Вручную через Vue Router (обрабатывается Nuxt i18n)
    Динамическая генерация маршрутов Да Плагин/экосистема или ручная настройка Не предоставляется Плагин/ручная настройка Да Да Не предоставляется (предоставляется Nuxt i18n)
    Множественное число Шаблоны на основе перечислений; см. документацию Настраиваемо (плагины, такие как i18next-icu) Продвинутое (ICU) Продвинутое (ICU/messageformat) Хорошо Хорошо Продвинутое (встроенные правила множественного числа)
    Форматирование (даты, числа, валюты) Оптимизированные форматтеры (Intl под капотом) Через плагины или пользовательское использование Intl Продвинутые ICU форматтеры Помощники ICU/CLI Хорошо (помощники Intl) Хорошо (помощники Intl) Встроенные форматтеры даты/числа (Intl)
    Формат содержимого .tsx, .ts, .js, .json, .md, .txt .json .json, .js .po, .json .json, .js, .ts .json .json, .js
    Поддержка ICU В разработке (родной ICU) Через плагин (i18next-icu) Да Да Да Через плагин (i18next-icu) Через пользовательский форматтер/компилятор
    SEO помощники (hreflang, sitemap) Встроенные инструменты: помощники для sitemap, robots.txt, метаданные Плагины сообщества/ручное управление Не является ядром Не является ядром Хорошо Хорошо Не является ядром (Nuxt i18n предоставляет помощники)
    Экосистема / Сообщество Меньше, но быстро растет и активно реагирует Самое большое и зрелое Большое, корпоративное Растущее, меньше Среднего размера, ориентировано на Next.js Среднего размера, ориентировано на Next.js Большое в экосистеме Vue
    Серверный рендеринг и серверные компоненты Да, оптимизировано для SSR / React Server Components Поддерживается, требуется некоторая настройка Поддерживается в Next.js Поддерживается Полная поддержка Полная поддержка SSR через Nuxt/Vue SSR (без RSC)
    Tree-shaking (загрузка только используемого контента) Да, на уровне компонентов во время сборки с помощью плагинов Babel/SWC Обычно загружает всё (можно улучшить с помощью пространств имён/разделения кода) Обычно загружает всё Не по умолчанию Частично Частично Частично (с разделением кода/ручной настройкой)
    Ленивая загрузка Да, по локалям/по компонентам Да (например, бэкенды/пространства имён по требованию) Да (разделение пакетов локалей) Да (динамический импорт каталогов) Да (по маршрутам/локалям) Да (по маршрутам/локалям) Да (асинхронные сообщения локалей)
    Управление крупными проектами Поощряет модульность, подходит для дизайн-систем Требует хорошей дисциплины в работе с файлами Центральные каталоги могут стать большими Может стать сложным Модульный с настройкой Модульный с настройкой Модульный с настройкой Vue Router/Nuxt i18n

    История документа

    Версия Дата Изменения
    5.8.0 2025-08-19 Обновление сравнительной таблицы
    5.5.10 2025-06-29 Инициализация истории
    Получайте уведомления о предстоящих релизах Intlayer