15  /  46

Коллекции блоков

Просмотров: 1480 (Статистика ведётся с 06.02.2017)

Блок пользователя

USER - вывод блока с аватаром и именем пользователя. Поля AVATAR (аватар) и LINK (ссылка) не являются обязательными.

Пример:

Array("USER" => Array(
   "NAME" => "Иван Иванов",
   "AVATAR" => "http://shelenkov.com/bitrix/images/avatar.png",
   "LINK" => "http://shelenkov.com/",
)),

Вместо ключа LINK можно использовать и ссылки на сущности:

  • CHAT_ID => 1 - для указания ссылки на чат;
  • BOT_ID => 66 - для указания ссылки на бота;
  • USER_ID => 1 - для указания ссылки на пользователя.


Блок со ссылками

LINK - вывод блока с ссылкой на ресурс, описанием и картинкой-пояснением. Этот блок используется при автоматическом создании «богатых ссылок». Поля DESC (описание) и PREVIEW (картинка) не являются обязательными полями.

Пример:


Array("LINK" => Array(
   "NAME" => "Тикет #12345: новое API для модуля \"Веб-мессенджер\"",
   "DESC" => "Необходимо реализовать к релизу!",
   "LINK" => "https://api.bitrix24.com/",
   "PREVIEW" => "http://dev.1c-bitrix.ru/bitrix/templates/1c-bitrix-new/images/logo.png"
)),

Вместо ключа LINK можно использовать и ссылки на сущности:

  • CHAT_ID => 1 - для указания ссылки на чат;
  • USER_ID => 1 - для указания ссылки на пользователя.


Блок с текстом

MESSAGE - вывод простого текста без форматирования.

Пример:

Array("MESSAGE" => "API будет доступно в обновлении [B]im 16.0.0[/B]"),

В тексте доступны bb-коды: USER, CHAT, SEND, PUT, CALL, BR, B, U, I, S.



Блок c разделителем

DELIMITER - вывод разделителя, можно задать цвет и размер. Поля COLOR (цвет) и SIZE (размер) не являются обязательными полями.

Пример:

Array("DELIMITER" => Array(
   'SIZE' => 200,
   'COLOR' => "#c6c6c6"
)),


Блок для построения строк и колонок

GRID - существует три представления блока: блочное, строчное и в виде 2х колонок.

  1. "DISPLAY" => "BLOCK" - Блочное - данные идут друг под другом.

    Доступен ключ WIDTH для указания ширины блока (в пикселях).

    Пример:

    Array("GRID" => Array(
        Array(
            "NAME" => "Описание",
            "VALUE" => "Требуется реализовать возможность добавлять структурированные сущности в сообщения и уведомления мессенджера.",
            "DISPLAY" => "BLOCK",
            "WIDTH" => "250"
        ),
        Array(
            "NAME" => "Категория",
            "VALUE" => "Пожелания",
            "DISPLAY" => "BLOCK"
        ),
    )),
    
  2. "DISPLAY" => "LINE" - Строчное - каждый блок идет друг за другом пока не закончится доступное место, после чего переносится на новую строку.

    Доступен ключ WIDTH для указания ширины блока (в пикселях).

    Пример:

    Array("GRID" => Array(
       Array(
          "NAME" => "Приоритет",
          "VALUE" => "Высокий",
          "COLOR" => "#ff0000",
          "DISPLAY" => "LINE",
           "WIDTH" => "250"
       ),
       Array(
          "NAME" => "Категория",
          "VALUE" => "Пожелания",
          "DISPLAY" => "LINE"
       ),
    )), 
    
  3. "DISPLAY" => "COLUMN" - Построение в виде двух колонок.

    Доступен ключ WIDTH для указания ширины первой колонки (в пикселях).

    Пример:

    Array("GRID" => Array(
        Array(
            "NAME" => "Приоритет",
            "VALUE" => "Высокий",
            "DISPLAY" => "COLUMN"
            "WIDTH" => "250"
        ),
        Array(
            "NAME" => "Категория",
            "VALUE" => "Пожелания",
            "DISPLAY" => "COLUMN"
        ),
    )),
    

Для всех видов блоков для построения строк и колонок доступны дополнительные ключи:

  • COLOR - цвет значения;
  • CHAT_ID - значение станет ссылкой на чат в веб-мессенджере;
  • USER_ID - значение станет ссылкой на пользователя в веб-мессенджере;
  • LINK - значение станет ссылкой.
  • Для ключа VALUE доступны bb-коды: USER, CHAT, SEND, PUT, CALL.


Блок c изображениями

IMAGE - блок с изображениями. Рекомендуется заполнять поле PREVIEW с указанием уменьшенной копии изображения, если поле не заполнено используется LINK. Поля NAME (название) и PREVIEW (картинка-превью) не являются обязательными.

Пример:

Array("IMAGE" => Array(
    Array(
        "NAME" => "Это Mantis",
        "LINK" => "http://shelenkov.com/bitrix/images/mantis.jpg",
        "PREVIEW" => "http://shelenkov.com/bitrix/images/mantis.jpg"
    )
)),


Блок с файлами

FILE - отображает форматированную ссылку для загрузки файла. Размер файла необходимо указывать в байтах. Поля NAME (название файла), SIZE (размер файла) не являются обязательными.

Пример:

Array("FILE" => Array(
    Array(
        "NAME" => "mantis.jpg",
        "LINK" => "http://shelenkov.com/bitrix/images/mantis.jpg",
        "SIZE" => "1500000"
    )
)),


2
Курсы разработаны в компании «1С-Битрикс»