Функции разметки
Функции разметки используются для создания размеченного текста (гипертекста) из строковых значений и/или из другого размеченного текста.
Особенности использования
Существуют следующие особенности использования функций разметки:
- Эти функции возвращают
NULL
при наличииNULL
в любом из аргументов. Чтобы получить при этом значение, можно обернуть аргументы вIFNULL()
. Пример:BOLD(IFNULL([value], 'NULL'))
. - Конвертация размеченного текста в обычные строковые значения не поддерживается.
- Функции разметки могут использоваться внутри логических функций. Пример:
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
— возвращает имя.
Если пользователь не найден, возвращается оригинальная строка из источника.