---
title: "Экспресс-блоки"
id: "ekspress-bloki"
project: "Руководство пользователя Документерры"
url: "https://docs.documenterra.ru/articles/manual/ekspress-bloki"
updated: 2026-11-16T06:45:03Z
---

# Экспресс\-блоки

Экспресс-блоки —это небольшие фрагменты, которые можно вставлять в контент. Они помогают ускорить выполнение рутинных задач, таких как вставка определенных повторяющихся фрагментов контента в документацию. Вы можете создать экспресс-блок из любого фрагмента вашего контента, включая [переменные](/articles/manual/ispolzovaniye-peremennykh-v-kontente-stranitsy), [сниппеты](/articles/manual/content-snippets), [условные блоки](/articles/manual/dynamic-conditional-content) и др.

Для быстрого перехода к определенному разделу данной страницы используйте следующие ссылки:

* [Создание экспресс-блока](/articles/manual/ekspress-bloki/a/h2__504016989)
* [Создание из редактора страницы](/articles/manual/ekspress-bloki/a/h3_924857875)
* [Создание через настройки портала](/articles/manual/ekspress-bloki/a/h3_1622566963)
* [Вставка экспресс-блока](/articles/manual/ekspress-bloki/a/h2__1150850813)
* [Редактирование экспресс-блока](/articles/manual/ekspress-bloki/a/h2__11525345612)
* [Удаление экспресс-блока](/articles/manual/ekspress-bloki/a/h2__193691286)
* [Экспресс-блоки для API-документации](/articles/manual/ekspress-bloki/a/h2_640956000)
* [Часто задаваемые вопросы](/articles/manual/ekspress-bloki/a/h2_344007839)

По умолчанию в системе Документерра доступно более десяти экспресс-блоков, включая информационное окно, окно предупреждения, элемент «Меню действий» и экспресс-блоки API.

В отличие от [сниппетов](/articles/manual/content-snippets), экспресс-блоки —это фрагменты контента, которые вставляются непосредственно на страницу. После вставки экспресс-блока он становится частью контента страницы, что позволяет изменять его на месте. Это похоже на вставку контента из буфера обмена.

| Совместное использование экспресс-блоков осуществляется в масштабах портала, что означает, что каждый пользователь имеет один и тот же список экспресс-блоков. Не существует специфических для конкретного проекта или пользователя экспресс-блоков. |
| --- |

## Создание экспресс-блока

Вы можете создать новый экспресс-блок одним из следующих способов.

### Создание из редактора страницы

1. Выберите контент страницы, на основе которого необходимо создать экспресс-блок. 

    | Если вы хотите создать экспресс-блок из пользовательского HTML, прочитайте инструкцию [, приведенную ниже](/articles/manual/ekspress-bloki/a/h3_1690352554). |
    | --- |
2. Выберите в верхней панели вкладку **Вставка** и нажмите кнопку **Создать из выбранного** в группе **Экспресс-блоки**. В качестве альтернативы нажмите Ctrl+Q (Command-Q в MacOS) 
 ![Кнопка «Создать из выбранного» на вкладке «Вставка» верхней панели](/resources/Storage/manual/documenterra_baselang/Screenshots/quick-parts/create-button.png)
3. Появится диалоговое окно **Создание экспресс-блока**. 
 ![Диалоговое окно «Создание экспресс-блока»](/resources/Storage/manual/documenterra_baselang/Screenshots/quick-parts/create-modal-window.png)
    * Необходимо указать имя экспресс-блока. Если указать (или выбрать из списка) имя уже существующего экспресс-блока, то существующий экспресс-блок будет перезаписан новым.
    * Щелкните на ссылке **Показать исходный код экспресс-блока**, чтобы увидеть HTML-файл экспресс-блока. Вы также можете отредактировать его, если необходимо изменить что-то в процессе работы или очистить разметку.

### Создание через настройки портала

Вы также можете централизованно управлять экспресс-блоками и создавать их:

1. Перейдите в **Настройки → Шаблоны контента → Экспресс-блоки**.
2. Нажмите кнопку **Создать новый файл**.![Создание нового экспресс-блока.](/resources/Storage/manual/ekspress-bloki/sozdanie-ekspress-bloka.png)
3. В списке появится новый экспресс-блок. Выберите его и нажмите **Переименовать**, чтобы дать ему новое название. 
 ![Переименовать новый экспресс-блок.](/resources/Storage/manual/ekspress-bloki/pereimenovat-ekspress-blok.png)
4. Используйте редактор в правой части экрана, чтобы сформировать содержимое нового экспресс-блока.![Редактор экспресс-блока.](/resources/Storage/manual/ekspress-bloki/redaktor-ekspross-bloka.png)

| Редактор экспресс-блоков использует файл **Style.css** из шаблона пустого проекта. Этот файл находится в [Хранилище файлов](/articles/manual/hranilishye-faylov) по пути: resources/Styles/Templates/blank-template/Style.css. Если в вашем проекте используются пользовательские стили, они будут применены к экспресс-блоку при вставке. В результате экспресс-блок может выглядеть в вашем проекте иначе, чем в редакторе экспресс-блоков. |
| --- |

## Вставка экспресс-блока

Процесс вставки экспресс-блока довольно прост:

1. Переключитесь на вкладку **Вставка** в верхней панели и нажмите кнопку **Вставка** группы **Экспресс-блоки**.
2. Щелкните на нужном экспресс-блоке из списка.

Экспресс-блок будет вставлен в место расположения текстового курсора.

## Редактирование экспресс-блока

Изменить существующие экспресс-блоки можно через настройки портала:

1. Перейдите в **Настройки → Шаблоны контента → Экспресс-блоки**.
2. Выберите экспресс-блок, который хотите отредактировать, из списка.
3. Внесите изменения с помощью редактора в правой части страницы.![Редактирование экспресс блока.](/resources/Storage/manual/ekspress-bloki/redaktirovanie-ekspress-bloka.png)
4. Сохраните изменения.

Чтобы переименовать экспресс-блок, выберите его из списка и нажмите кнопку **Переименовать**.

![Переименование существующего экспресс-блока.](/resources/Storage/manual/ekspress-bloki/pereimenovanie-ekspess-bloka.png)

##  Удаление экспресс-блока

Любой пользователь с правами доступа автора, кроме рецензентов, может удалить экспресс-блок.

| ![](/resources/Storage/manual/documenterra_baselang/Images/quick-parts/icon-warning.svg) | Внимание |
| --- | --- |
| Если вы удалите экспресс-блок, он будет удален для всех пользователей портала. |

1. Наведите указатель мыши на конкретный экспресс-блок во всплывающем окне «Вставка экспресс-блока»
2. Нажмите кнопку **Удалить** (иконка с изображением ведра). 
 ![Для удаления экспресс-блока нажмите кнопку «Удалить»](/resources/Storage/manual/documenterra_baselang/Screenshots/quick-parts/delete-quick-part.png)

Вы также можете удалить экспресс-блок из настроек портала. Для этого перейдите в **Настройки → Шаблоны контента → Экспресс-блоки**, выберите нужный экспресс-блок и нажмите кнопку **Удалить**.

![Удаление экспресс-блока из настроек портала.](/resources/Storage/manual/ekspress-bloki/udalit-ekspress-blok.png)

## Экспресс-блоки для API-документации

Документерра предоставляет несколько стандартных элементов, популярных в документах API, уже в готовом виде. Помимо того, что они доступны в меню вставки экспресс-блоков, связанные с API экспресс-блоки также доступны на отдельной вкладке в верхней панели:

![Вкладка «Экспресс-блоки для API-документации» в верхней панели](/resources/Storage/manual/documenterra_baselang/Screenshots/quick-parts/api-docs-tab.png)

Это отличная отправная точка, которую можно использовать, чтобы ускорить процесс написания документации по API. С помощью этих «строительных кирпичей» можно быстро собрать типовые страницы документации по API. Например, таблица элементов может использоваться для описания как параметров запроса, так и полей ответа.

| ![](/resources/Storage/manual/documenterra_baselang/Images/quick-parts/icon-warning.svg) | Внимание |
| --- | --- |
| Если вы удалите экспресс-блок для API-документации из меню вставки экспресс-блоков, то не сможете вставить его, нажав соответствующую кнопку на вкладке API-документации в верхней панели. Для восстановления работоспособности кнопок в верхней панели необходимо создать экспресс-блок с соответствующим именем. |

## Часто задаваемые вопросы

Можно ли настроить экспресс-блоки для API-документации?
 
Да. Поскольку эти элементы являются экспресс-блоками, их можно настраивать как по разметке, так и по стилю. Чтобы узнать, как модифицировать экспресс-блоки, обратитесь к [соответствующему разделу выше](/articles/manual/ekspress-bloki/a/h2__11525345612).

| ![](/resources/Storage/manual/documenterra_baselang/Images/quick-parts/icon-tip.svg) | Совет |
| --- | --- |
| Чтобы изменить внешний вид и функциональность экспресс-блоков для API-документации, найдите в CSS-файлах проектов соответствующие правила CSS, добавленные автоматически при обновлении портала в разделе с заголовком /\* Элементы API-документации —начало \*/. |

Можно ли создавать новые экспресс-блоки для API-документации?
 
Да. Как и в случае с любыми другими экспресс-блоками, вы можете таким же образом добавлять экспресс-блоки для API-документов. Чтобы узнать, как это сделать, смотри [соответствующий раздел выше](/articles/manual/ekspress-bloki/a/h2__504016989).

| ![](/resources/Storage/manual/documenterra_baselang/Images/quick-parts/icon-info.svg) | Примечание |
| --- | --- |
| При создании пользовательских экспресс-блоков для API-документации, которые не предоставляются в готовом виде, они не будут отображаться в виде кнопок на верхней панели на вкладке API-документации. |

Чем экспресс-блоки отличаются от сниппетов?
 
Хотя на первый взгляд разница между экспресс-блоками и [сниппетами контента](/articles/manual/content-snippets) может быть неочевидна и они могут показаться похожими, по своей сути они сильно отличаются.

| **Экспресс-блоки** | **Сниппеты** |
| --- | --- |
| Разметка экспресс-блока становится частью разметки страницы при вставке | Разметка сниппета становится частью разметки страницы при публикации |
| Хранятся в данных портала, вне страниц | Должны существовать как отдельные страницы |
| Возможность редактирования при вставке | Не могут быть отредактированы на странице, в которую они вставлены |
| Если на странице редактируется один из вставленных экспресс-блоков, то изменения вносятся только в редактируемый объект | При редактировании исходного сниппета изменения отражаются в каждом вставленном экземпляре этого сниппета во всех проектах |

Я случайно удалил экспресс-блок, что мне делать?
 
Вы всегда можете создать новый, следуя инструкциям, приведенным [выше](/articles/manual/ekspress-bloki/a/h2__504016989).

Как создать экспресс-блок из пользовательского HTML-кода?

1. **Выберите** что-либо на странице, чтобы активировать кнопку **Создать из выбранного**.
2. Нажмите кнопку **Создать из выбранного**.
3. Во всплывающем окне нажмите кнопку **Показать исходный код экспресс-блока**. 
 ![Ссылка «Показать исходный код экспресс-блока» в диалоговом окне «Создание экспресс-блока»](/resources/Storage/manual/documenterra_baselang/Screenshots/quick-parts/quick-parts-source.png)
4. Замените исходный код на свой собственный пользовательский HTML-код.
5. Не забудьте указать имя экспресс-блока и нажмите кнопку OK.