Блок таблицы GRID

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Блок GRID выводит данные в табличном формате пар «название-значение» с разными вариантами отображения.

Варианты отображения

  • BLOCK — каждый элемент GRID выводится отдельным блоком на новой строке, вертикальный список.
  • LINE — элементы выводятся в одну строку как карточки, при нехватке ширины переносятся на следующую строку.
  • ROW — классический двухколоночный формат «NAME | VALUE».
  • TABLE — табличный режим с более плотной сеткой; поддержка зависит от версии приложения клиента. В некоторых клиентах может отображаться как ROW.

Как это выглядит в интерфейсе

  • BLOCK

    Поля идут друг под другом, каждое с новой строки.

    Пример:

    Проект: BUGS
Категория: im
Сводка: Требуется реализовать...

  • LINE

    Поля показываются как компактные карточки в одну строку. Если места не хватает, карточки переносятся на следующую строку.

    Пример:

    [Проект: BUGS] [Категория: im] [Приоритет: Высокий]
[Исполнитель: Иван Иванов]

  • ROW

    Пары «название-значение» выводятся в две колонки: слева NAME, справа VALUE.

    Пример:

    Проект      | BUGS
Категория   | im
Приоритет   | Высокий

  • TABLE

    Табличный вариант с более плотной сеткой. В зависимости от клиента может выглядеть как ROW.

    Пример:

    Проект    | BUGS
Категория | im
Дедлайн   | 24.06.2026 17:50:43

Важно

В рамках одной записи GRID не смешивайте разные форматы отображения. Если нужны разные типы представления, создавайте отдельные блоки GRID.

Общие параметры элемента GRID

Название
тип

Описание

DISPLAY*
string

Формат отображения: BLOCK, LINE, ROW, TABLE

NAME
string

Название поля. В режиме ROW может отсутствовать, тогда VALUE занимает всю ширину строки

VALUE
string

Значение поля. Для VALUE поддерживаются BB-коды. В режиме ROW может отсутствовать, тогда NAME занимает всю ширину строки

WIDTH
integer

Ширина блока или колонки в пикселях

HEIGHT
integer

Высота блока в пикселях

COLOR_TOKEN
string

Токен цвета значения: primary, secondary, alert, base

COLOR
string

HEX-цвет значения (#RGB или #RRGGBB)

LINK
string

Внешняя ссылка для значения

USER_ID
integer

Внутренняя ссылка на пользователя

CHAT_ID
integer

Внутренняя ссылка на чат

Поддерживаемые BB-коды для VALUE

Код

Назначение

USER

Упоминание пользователя со ссылкой на профиль в чате

CHAT

Ссылка на чат

SEND

Кликабельное действие «отправить текст в чат»

PUT

Кликабельное действие «подставить текст в поле ввода»

CALL

Кликабельное действие для звонка

BR

Перенос строки

B

Жирный текст

U

Подчеркнутый текст

I

Курсив

S

Зачеркнутый текст

URL

Ссылка

Примеры

Как использовать примеры в документации

Блочное представление

DISPLAY: 'BLOCK' выводит элементы друг под другом.

Блочное представление

Пример

{
    GRID: [
        {
            NAME: 'Описание',
            VALUE: 'Требуется реализовать возможность добавлять структурированные сущности в сообщения и уведомления мессенджера.',
            DISPLAY: 'BLOCK',
            WIDTH: 250
        },
        {
            NAME: 'Категория',
            VALUE: 'Пожелания',
            DISPLAY: 'BLOCK',
            WIDTH: 100
        }
    ]
}

[
    'GRID' => [
        [
            'NAME' => 'Описание',
            'VALUE' => 'Требуется реализовать возможность добавлять структурированные сущности в сообщения и уведомления мессенджера.',
            'DISPLAY' => 'BLOCK',
            'WIDTH' => 250
        ],
        [
            'NAME' => 'Категория',
            'VALUE' => 'Пожелания',
            'DISPLAY' => 'BLOCK',
            'WIDTH' => 100
        ]
    ]
]

Строчное представление

DISPLAY: 'LINE' выводит элементы в строку с переносом на следующую строку при нехватке места.

Строчное представление

В мобильной версии элементы выводятся друг под другом:

Строчное представление (mobile)

Пример

{
    GRID: [
        {
            NAME: 'Приоритет',
            VALUE: 'Высокий',
            COLOR_TOKEN: 'alert',
            COLOR: '#ff0000',
            DISPLAY: 'LINE',
            WIDTH: 250
        },
        {
            NAME: 'Категория',
            VALUE: 'Пожелания',
            DISPLAY: 'LINE'
        }
    ]
}

[
    'GRID' => [
        [
            'NAME' => 'Приоритет',
            'VALUE' => 'Высокий',
            'COLOR_TOKEN' => 'alert',
            'COLOR' => '#ff0000',
            'DISPLAY' => 'LINE',
            'WIDTH' => 250
        ],
        [
            'NAME' => 'Категория',
            'VALUE' => 'Пожелания',
            'DISPLAY' => 'LINE'
        ]
    ]
]

Представление в виде двух колонок

DISPLAY: 'ROW' выводит данные в две колонки.

Построение в виде двух колонок

Пример

{
    GRID: [
        {
            NAME: 'Приоритет',
            VALUE: 'Высокий',
            DISPLAY: 'ROW'
        },
        {
            NAME: 'Категория',
            VALUE: 'Пожелания',
            DISPLAY: 'ROW'
        }
    ]
}

[
    'GRID' => [
        [
            'NAME' => 'Приоритет',
            'VALUE' => 'Высокий',
            'DISPLAY' => 'ROW',
            'WIDTH' => 250
        ],
        [
            'NAME' => 'Категория',
            'VALUE' => 'Пожелания',
            'DISPLAY' => 'ROW'
        ]
    ]
]

Табличное представление

DISPLAY: 'TABLE' выводит пары NAME и VALUE в компактной таблице.

Пример

{
    GRID: [
        {
            NAME: 'Проект',
            VALUE: 'BUGS',
            DISPLAY: 'TABLE'
        },
        {
            NAME: 'Категория',
            VALUE: 'im',
            DISPLAY: 'TABLE'
        },
        {
            NAME: 'Дедлайн',
            VALUE: '24.06.2026 17:50:43',
            DISPLAY: 'TABLE'
        }
    ]
}

[
    'GRID' => [
        [
            'NAME' => 'Проект',
            'VALUE' => 'BUGS',
            'DISPLAY' => 'TABLE'
        ],
        [
            'NAME' => 'Категория',
            'VALUE' => 'im',
            'DISPLAY' => 'TABLE'
        ],
        [
            'NAME' => 'Дедлайн',
            'VALUE' => '24.06.2026 17:50:43',
            'DISPLAY' => 'TABLE'
        ]
    ]
]

Продолжите изучение

Предыдущая
Блок с разделителем
Следующая
Блок с изображениями