Новое в Figma: управление ключами, варианты и экспорт в JSON

Плагин Smartcat для Figma получил масштабное обновление режима перевода ассетов: теперь каждый текстовый объект получает настраиваемый ключ, один элемент может содержать несколько вариантов контента, а всю локализацию можно экспортировать в виде готового для разработчиков JSON-файла. Эти функции уже доступны всем пользователям по умолчанию.

Удобная передача разработчикам. Каждый текстовый объект получает автоматически сгенерированный ключ, который можно переименовать в любой момент. Это означает, что контент в Figma напрямую связывается с ключами, которые ваша команда разработчиков уже использует в коде.

Один дизайн, множество состояний контента. Варианты позволяют одному текстовому объекту содержать несколько версий контента (например, пустое состояние, состояние загрузки, состояние ошибки) в рамках одного элемента, каждый со своим ключом. Больше не нужно дублировать слои только для того, чтобы показать альтернативный текст.

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

Меньше дублирующихся строк. При создании проекта Smartcat из плагина сегменты с одинаковыми ключами автоматически объединяются, поэтому переводчики видят и переводят каждую строку только один раз, независимо от того, сколько раз она повторяется в ваших макетах.

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

1. Откройте вкладку Keys and Variants. Здесь перечислены все текстовые объекты в вашем файле вместе с их ключами. Ключи генерируются автоматически, но вы также можете задать их вручную для любого объекта.

2. Добавляйте варианты там, где это необходимо. Выберите текстовый объект и нажмите + Add variant, чтобы прикрепить альтернативный контент. Каждый вариант получает собственный автоматически сгенерированный (или заданный вручную) ключ, и вы можете переключаться между вариантами для предварительного просмотра каждого из них прямо на холсте Figma.

3. Разрешите конфликты ключей. Если два разных текстовых фрагмента имеют один и тот же ключ, плагин отобразит это на вкладке Error. Исправьте это, сделав текст одинаковым или изменив один из ключей, применив изменение ко всем совпадающим экземплярам одновременно.

4. Отметьте контент как переводимый или непереводимый. Сделайте любой текстовый объект непереводимым; он останется видимым на вкладке Keys and Variants, но будет собран отдельно на новой вкладке Untranslatable.

5. Создайте проект в Smartcat. Запустите перевод прямо из плагина. Сегменты с одинаковым ключом объединяются автоматически, а при выборе сегмента с вариантом в предпросмотре Figma отображается именно этот вариант, поэтому проверять переведенные варианты так же просто, как и исходный текст.

Переводы также можно редактировать напрямую, на холсте или в списке переводов. Перевод, отредактированный вручную, не будет перезаписан функцией Translate instantly, хотя он все равно может быть обновлен при синхронизации контента со Smartcat.

6. Экспортируйте в JSON. Когда переводы будут готовы, нажмите Export JSON, чтобы скачать файл со списком ID узлов Figma для каждого объекта, ключами, исходным текстом, переводами на каждый язык и любыми вариантами, который можно сразу передать разработчикам.

Откройте плагин Smartcat в Figma и переключитесь в режим Asset translation mode.

Новая вкладка Keys and Variants находится рядом с существующими вкладками, а Untranslatable и Export JSON доступны на той же панели.

Если вы работаете в режиме Software localization mode, обратите внимание на две переименованные вкладки: Text objects теперь называется Keys, а Hidden — Untranslatable. Сам рабочий процесс не изменился, а варианты в этом режиме не поддерживаются.

Это решение создано для команд дизайна и разработки продуктов, выпускающих многоязычные интерфейсы, а также для разработчиков, которые используют их результаты. Дизайнеры получают более удобный способ управления повторяющимся контентом и контентом, зависящим от состояния, не загромождая свои файлы, команды локализации получают меньше дублирующихся строк для перевода, а инженеры — готовый файл ресурсов JSON вместо ручного сопоставления текста из Figma с ключами локализации.