Атрибут translate тега <summary>
Описание
Атрибут translate определяет, должен ли текст внутри элемента <summary> переводиться при использовании автоматических инструментов перевода (например, Google Translate). Это полезно для контента, который не должен переводиться (имена собственные, коды, термины).
<details>
<summary translate="no">COVID-19 FAQ</summary>
<p>Часто задаваемые вопросы о коронавирусе...</p>
</details>
<details>
<summary>Общие вопросы</summary>
<p>Эта секция будет переведена автоматически...</p>
</details>
Значения атрибута:
| Значение | Описание | Когда использовать |
|---|---|---|
yes |
Разрешить перевод (значение по умолчанию) | Для обычного текста, который нужно переводить |
no |
Запретить перевод | Для имен собственных, кодов, терминов |
Особенности работы:
- Работает только с автоматическими переводчиками (браузерными и онлайн)
- Не влияет на ручной перевод контента
- Поддерживается большинством современных браузеров
- Наследуется дочерними элементами
Пример с техническими терминами:
<details>
<summary translate="no">API v2.3 Documentation</summary>
<p translate="yes">Полное руководство по использованию нашего API...</p>
</details>
Рекомендации:
- Используйте
translate="no"для:- Имен собственных (люди, компании)
- Кодов, версий, идентификаторов
- Терминов, которые должны оставаться на языке оригинала
- Сочетайте с атрибутом
langдля лучшего определения языка - Для частей текста внутри элемента используйте
<span translate="...">
Ограничения:
- Не все инструменты перевода учитывают этот атрибут
- Не заменяет профессиональную локализацию контента
- Может игнорироваться в некоторых мобильных приложениях
Пример с частичным переводом:
<details>
<summary>
<span translate="no">React</span> - Руководство для начинающих
</summary>
<p>Изучите основы React...</p>
</details>
Примечание: Для важного контента, который не должен переводиться, лучше использовать визуальное выделение (например, код в тегах <code>) в дополнение к атрибуту translate.