Управление Capture mode в пакете tcolorbox

Capture Mode определяет, как содержимое tcolorbox обрабатывается и отображается.

Capture Mode в tcolorbox

Capture Mode определяет, как содержимое tcolorbox обрабатывается и отображается.
Доступные режимы:

  • minipage (по умолчанию для tcolorbox)
  • hbox (по умолчанию для \tcbox)
  • fitbox (требует библиотеку fitting)

1. Основные команды и стили

Команда / Опция Синтаксис Описание
capture=<mode> \begin{tcolorbox}[capture=minipage] ... \end{tcolorbox} Устанавливает режим обработки содержимого (minipage, hbox, fitbox).
hbox (стиль) \begin{tcolorbox}[hbox] ... \end{tcolorbox} Короткая запись для capture=hbox.
minipage (стиль) \begin{tcolorbox}[minipage] ... \end{tcolorbox} Короткая запись для capture=minipage.
fitbox (стиль) \begin{tcolorbox}[fitbox] ... \end{tcolorbox} Короткая запись для capture=fitbox (требует \tcbuselibrary{fitting}).

2. Примеры использования

2.1. Режим minipage (по умолчанию)

\begin{tcolorbox}[
    capture=minipage, % можно опустить (стоит по умолчанию)
    colframe=blue,
    colback=white,
    title=Minipage Mode
]
Этот блок ведёт себя как `minipage`.  
Можно разбивать на части (`breakable`), добавлять верхнюю и нижнюю части.
\end{tcolorbox}

Особенности:

  • Поддерживает breakable (разрыв на страницах).
  • Можно использовать upper и lower части.

2.2. Режим hbox (как \tcbox)

\begin{tcolorbox}[
    hbox, % короткая запись для capture=hbox
    colframe=red,
    colback=white,
    title=HBox Mode
]
Этот блок ведёт себя как `\hbox` (аналогично `\tcbox`).
\end{tcolorbox}

Особенности:

  • Нельзя разбивать (breakable не работает).
  • Размер подстраивается под содержимое.

2.3. Режим fitbox (требует fitting)

\usepackage{tcolorbox}
\tcbuselibrary{fitting} % обязательно подключить

\begin{tcolorbox}[
    fitbox, % короткая запись для capture=fitbox
    height=2cm,
    width=6cm,
    colframe=green,
    colback=white,
    title=FitBox Mode
]
Содержимое масштабируется под размер блока.
\end{tcolorbox}

Особенности:

  • Размер содержимого подгоняется под заданные размеры блока.
  • Полезно для создания блоков фиксированного размера.

3. Сравнение режимов

Режим Разрыв (breakable) Размер Использование
minipage Да Под содержимое Основные блоки с текстом
hbox Нет Под содержимое Компактные блоки (\tcbox)
fitbox Нет Фиксированный Блоки с жёсткими размерами

4. Полный пример с разными режимами

\documentclass{article}
\usepackage{tcolorbox}
\tcbuselibrary{fitting} % для fitbox

\begin{document}

\begin{tcolorbox}[
    minipage, % или capture=minipage
    colframe=blue,
    title=Minipage Mode,
    breakable % можно разрывать
]
Этот блок ведёт себя как `minipage`.  
Можно разбивать на страницы и использовать `lower` и `upper` части.
\end{tcolorbox}

\begin{tcolorbox}[
    hbox,
    colframe=red,
    title=HBox Mode
]
Это компактный блок (`\hbox`).
\end{tcolorbox}

\begin{tcolorbox}[
    fitbox,
    width=5cm,
    height=3cm,
    colframe=green,
    title=FitBox Mode
]
Содержимое подгоняется под размер блока.
\end{tcolorbox}

\end{document}

Результат:

  • Первый блок (minipage) может быть разорван на страницы.
  • Второй блок (hbox) компактный, без разрывов.
  • Третий блок (fitbox) имеет фиксированный размер.