Размеры
Ширина по содержимому
Режим, в котором размер слайдов не задаётся слайдером, а определяется содержимым или вашими CSS-стилями.
Когда использовать
- Слайды разной ширины (горизонтальный слайдер) или разной высоты (вертикальный).
- Контент сам задаёт размер: карточки с разным текстом, изображения с разными пропорциями.
- Нужна карусель «как есть», без приведения всех слайдов к одному размеру.
Auto Width (горизонтальный слайдер)
При autoWidth: true слайдер не устанавливает слайдам width. Ширина берётся из:
- инлайн-стиля
style="width: ...", - CSS-классов,
- содержимого (например, изображения).
Живой пример
Ширина по содержимому
6 слайдов
HTML, CSS и JS в этих вкладках используются в предпросмотре.
Код примера (Auto Width)
Auto Height (вертикальный слайдер)
При direction: 'vertical' и autoHeight: true слайдер не задаёт слайдам высоту. Высота определяется вашими стилями или контентом.
Живой пример
Высота по содержимому
6 слайдов
HTML, CSS и JS в этих вкладках используются в предпросмотре.
Код примера (Auto Height)
Контейнеру слайдера нужно задать высоту (например, height: 320px), иначе вертикальный скролл не будет ограничен.
Опции
| Опция | Тип | По умолчанию | Описание |
|---|---|---|---|
autoWidth |
boolean |
false |
Ширина слайдов по содержимому (горизонтальный слайдер). |
autoHeight |
boolean |
false |
Высота слайдов по содержимому (вертикальный слайдер). |
Рекомендации
- perPage: 1 — в режиме auto размеры слайдов разные, на «странице» обычно показывается один слайд. Рекомендуется явно указать
perPage: 1. - Задайте размер слайдам — через
width/heightв стилях или через контент (например, изображения с явными размерами), иначе до первого измерения размер может быть нулевым. - Loop — режим
loop: trueс auto width/height поддерживается; клоны получают те же размеры, что и оригинальные слайды.
Как это работает
- Слайдер не устанавливает слайдам
width(приautoWidth) илиheight(приautoHeight), только отступыgap(margin). - После отрисовки измеряются фактические размеры слайдов из DOM (
offsetWidth/offsetHeight). - Позиции слайдов считаются как сумма размеров предыдущих слайдов плюс отступы.
- Навигация, drag, loop и остальные модули работают как обычно; при необходимости используется размер конкретного слайда через внутренний API.
Совместимость с другими опциями
- center — поддерживается, активный слайд центрируется по своему размеру.
- loop — поддерживается.
- peek — учитывается при расчёте видимой области.
- breakpoints — можно менять опции по ширине экрана; при смене breakpoint размеры пересчитываются при следующем
update()(в т.ч. при resize).
Отличия от обычного режима
| Параметр | Обычный режим | Auto Width / Auto Height |
|---|---|---|
| Размер слайда | Один на всех (по perPage) | Свой у каждого слайда (из DOM) |
| Кто задаёт размер | Слайдер | Ваши стили / контент |
| EndIndex | slideCount - perPage |
slideCount - 1 (по одному слайду) |
API
Размер конкретного слайда доступен через движок (для модулей и расширений):
При включённом auto-режиме возвращается измеренный размер слайда с заданным индексом.