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