Функции разметки

Функции разметки используются для создания размеченного текста (гипертекста) из строковых значений и/или из другого размеченного текста.

Особенности использования

Существуют следующие особенности использования функций разметки:

  1. Эти функции возвращают NULL при наличии NULL в любом из аргументов. Чтобы получить при этом значение, можно обернуть аргументы в IFNULL(). Пример: BOLD(IFNULL([value], 'NULL')).
  2. Конвертация размеченного текста в обычные строковые значения не поддерживается.
  3. Функции разметки могут использоваться внутри логических функций. Пример: IF(STARTSWITH([value], 'n'), BOLD([value]), MARKUP([value])).

BOLD

Синтаксис:BOLD( text )

Выделяет переданный текст жирным шрифтом.

BR

Синтаксис:BR()

Добавляет перенос строки.

COLOR

Синтаксис:COLOR( text, color )

Позволяет указать цвет для переданного текста.

Рекомендуем использовать для указания цветов переменные из палитры дизайн-системы Gravity UI. Эти цвета будут хорошо различимы как в светлой, так и в темной теме.

Также цвет можно указать в любом формате представления веб-цвета: HEX, ключевым словом (например, green), RGB и т. д. Но в этом случае мы не гарантируем различимость цветов.

IMAGE

Синтаксис:IMAGE( src [ , width [ , height [ , alt ] ] ] )

Позволяет вставить в таблицу изображение, расположенное по адресу src. Ширина (width) и высота (height) изображения указываются в пикселях. Если для одного из размеров указано значение NULL, он рассчитывается автоматически пропорционально размеру другой стороны. Если для обоих размеров указано значение NULL, изображение вставляется с исходными размерами. В случае проблем с загрузкой изображения функция выводит альтернативный текст alt.

ITALIC

Синтаксис:ITALIC( text )

Выделяет переданный текст курсивом.

MARKUP

Синтаксис:MARKUP( arg_1, arg_2, arg_3 [ , ... ] )

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

SIZE

Синтаксис:SIZE( text, size )

Позволяет указать размер в пикселях для переданного текста.

URL

Синтаксис:URL( address, text )

Оборачивает text в ссылку на URL address. При переходе по ссылке страница открывается в новой вкладке браузера.

USER_INFO

Синтаксис:USER_INFO( user_id, user_info_type )

По идентификатору пользователя user_id возвращает размеченный текст для отображения его имени или email в зависимости от значения второго аргумента user_info_type:

  • email — возвращает email;
  • name — возвращает имя.

Если пользователь не найден, возвращается оригинальная строка из источника.

Предыдущая
Следующая