Управление 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) имеет фиксированный размер.