При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Контентный блок конфигурируемого дела», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.

Контентный блок конфигурируемого дела

Контентные блоки ContentBlockDto — основа контентной области записи таймлайна. Сочетая эти блоки можно гибко собирать различные интерфейсы.

Данная структура используется при создании конфигурируемых дел и при обогащении записей таймлайна контентными блоками.

Общая структура блока:

{
    "type": "Тип блока",
    "properties": {
        ... какие-то свойства, различные для каждого конкрентого блока
    }
}

Типы контентных блоков:

Текст

Самый простой блок type = text, который выводит некоторый форматированный текст.

Параметры

Пример

{
    "icon": {
        "code": "info"
    },
    "header": {
        "title": "Информационное сообщение"
    },
    "body": {
        "logo": {
            "code": "notification"
        },
        "blocks": {
            "text": {
                "type": "text",
                "properties": {
                    "value": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
                }
            }
        }
    }
}

!Текст

Длинный многострочный текст

Блок type = largeText позволяет отображать длинные многострочные тексты, которые будут автоматически свернуты до превью.

Параметры

Пример

Длинный текст, убранный под «Показать полностью».

{
    "icon": {
        "code": "info"
    },
    "header": {
        "title": "Информационное сообщение"
    },
    "body": {
        "logo": {
            "code": "notification"
        },
        "blocks": {
            "text": {
                "type": "largeText",
                "properties": {
                    "value": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat."
                }
            }
        }
    }
}

!Длинный текст

Ссылка

Блок type = link выводит ссылку.

Параметры

Пример

{
    "type": "link",
    "properties": {
     "text": "Открыть сделку",
     "action": {
        "type": "redirect",
        "uri": "/crm/deal/details/123/"
     },
     "bold": true
    }
}

!Ссылка

Блок с заголовком

Блок type = withTitle выводит пару название-значение. В качестве значения может быть использован другой контент-блок.

Параметры

Примеры

{
    "type": "withTitle",
    "properties": {
        "title": "Заголовок",
        "block": {
            "type": "text",
            "properties": {
                "value": "Какое-то значение"
            }
        }
    }
}

!Ссылка

{
    "type": "withTitle",
    "properties": {
        "title": "Заголовок 2",
        "block": {
            "type": "link",
            "properties": {
                "text": "Открыть сделку",
                "action": {
                    "type": "redirect",
                    "uri": "/crm/deal/details/123/"
                }
            }
        },
        "inline": true
    }
}

!Ссылка

Несколько контент-блоков в одну строку

Блок type = lineOfBlocks выводит в одну строку несколько контент-блоков типа текст или ссылка. Это позволяет выводить текст с разным форматированием, смешанный с ссылками, в одной строке.

Параметры

Примеры

{
    "type": "lineOfBlocks",
    "properties": {
        "blocks": {
            "text": {
                "type": "text",
                "properties": {
                    "value": "Какой-то текст"
                }
            },
            "link": {
                "type": "link",
                "properties": {
                    "text": "ссылка",
                    "action": {
                        "type": "redirect",
                        "uri": "/crm/deal/details/123/"
                    }
                }
            },
            "boldText": {
                "type": "text",
                "properties": {
                    "value": "жирный текст",
                    "bold": true
                }
            }
        }
    }
}

!Ссылка

Выбор крайнего срока

Блок type = deadline отображает текущее значение дедлайна с возможностью его быстро изменить. Блок не будет показан, если его добавить во входящее дело или в дело без дедлайна.

Параметры

Примеры

{
    "type": "deadline",
    "properties": {
        "readonly": false
    }
}

!Ссылка

• [](../../layout-blocks/index)
• [](../../../layout-blocks/index)
• [](./layout)
• [](./icon)
• [](./header)
• [](./body)
• [](./footer)
• [](./menu-item)
• [](./action)
• [](./field-types)
• [](./rest-app-layout-dto)
• [](./examples)