Документация для разработчиков
Темная тема

BX.translit

void|string
BX.translit(
	String str,
	Object params
);

Функция производит транслитерацию строки.

Параметры функции

Параметр Описание
str
params Возможные ключи объекта params:
  • max_len - максимальная длина результирующей строки;
  • change_case - к какому регистру приводить строку: L – к нижнему, U – к верхнему, false – не менять регистр;
  • replace_space - строка, на которую заменяются пробелы;
  • replace_other - строка, на которую заменяются остальные небуквенноцифровые символы;
  • delete_repeat_replace - флаг, удалять ли повторяющиеся небуквенноцифровые замены;
  • use_google - использовать ли внешний сервис для перевода строки перед транслитерацией. По умолчанию false.

    Параметр получил название из-за того, что раньше использовался сервис перевода Google.Translate. Поскольку сервис уже закрыт, то используется сервис Яндекс.Перевода. Имя параметра осталось для сохранения совместимости.

Помимо этого можно указать параметр callback, которому будет передан результат обработки. Если параметр use_google установлен в true, то callback обязателен.

Возвращаемое значение

Функция вернет транслитерированную строку (или ничего, если транслитерирование отложено параметром use_google.)



Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Valentin Borisenko
Для использования данной функции можно использовать серверный метод:

Код
CJSCore::Init(array('translit'));
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх