Получить код языка интерфейса BX24.getLang
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
BX24.getLang(): string;
Метод BX24.getLang возвращает код языка, на котором пользователь видит интерфейс Битрикс24, например ru или en. По этому коду приложение может выбрать язык своего интерфейса.
Значение приходит от Битрикс24 при инициализации библиотеки, поэтому вызывайте метод в обработчике BX24.init. Собственный scope методу не нужен.
Коды языков Битрикс24 не всегда совпадают со стандартом ISO 639-1. Например, украинский язык — ua, испанский — la, португальский — br, китайский — sc и tc.
Параметры метода
Без параметров.
Пример кода
Как использовать примеры в документации
Загрузить тексты приложения на языке пользователя, а для языков без перевода — на английском:
BX24.init(function () {
const supported = ['ru', 'en', 'de'];
const lang = supported.includes(BX24.getLang()) ? BX24.getLang() : 'en';
BX24.loadScript('lang/' + lang + '.js', function () {
console.log('Загружены тексты на языке', lang);
});
});
Обработка ответа
Метод синхронно возвращает результат типа string. Пример результата:
"ru"
Возвращаемые данные
|
Название |
Описание |
|
result |
Код языка интерфейса Битрикс24, например |
Обработка ошибок
Кодов ошибок метод не возвращает. Если вызвать его до инициализации библиотеки, он вернет пустую строку.