Миграция с 2.x на 3.0

Bootstrap 3 не имеет обратной совместимости с v2.x. Используйте этот раздел в качестве общего руководства по обновлению с версии 2.x до версии 3.0. Чтобы получить более широкий обзор, см . новые возможности в объявлении о выпуске версии 3.0.

Основные изменения класса

В этой таблице показаны изменения стиля между версиями 2.x и 3.0.

Начальная загрузка 2.x Начальная загрузка 3.0
.row-fluid .row
.span* .col-md-*
.offset* .col-md-offset-*
.brand .navbar-brand
.navbar .nav .navbar-nav
.nav-collapse .navbar-collapse
.nav-toggle .navbar-toggle
.btn-navbar .navbar-btn
.hero-unit .jumbotron
.icon-* .glyphicon .glyphicon-*
.btn .btn .btn-default
.btn-mini .btn-xs
.btn-small .btn-sm
.btn-large .btn-lg
.alert .alert .alert-warning
.alert-error .alert-danger
.visible-phone .visible-xs
.visible-tablet .visible-sm
.visible-desktop Разделить на.visible-md .visible-lg
.hidden-phone .hidden-xs
.hidden-tablet .hidden-sm
.hidden-desktop Разделить на.hidden-md .hidden-lg
.input-block-level .form-control
.control-group .form-group
.control-group.warning .control-group.error .control-group.success .form-group.has-*
.checkbox.inline .radio.inline .checkbox-inline .radio-inline
.input-prepend .input-append .input-group
.add-on .input-group-addon
.img-polaroid .img-thumbnail
ul.unstyled .list-unstyled
ul.inline .list-inline
.muted .text-muted
.label .label .label-default
.label-important .label-danger
.text-error .text-danger
.table .error .table .danger
.bar .progress-bar
.bar-* .progress-bar-*
.accordion .panel-group
.accordion-group .panel .panel-default
.accordion-heading .panel-heading
.accordion-body .panel-collapse
.accordion-inner .panel-body

Какие новости

Мы добавили новые элементы и изменили некоторые существующие. Вот новые или обновленные стили.

Элемент Описание
Панели .panel .panel-default .panel-body .panel-title .panel-heading .panel-footer .panel-collapse
Список групп .list-group .list-group-item .list-group-item-text .list-group-item-heading
Глификоны .glyphicon
Джамботрон .jumbotron
Очень маленькая сетка (<768px) .col-xs-*
Маленькая сетка (≥768px) .col-sm-*
Средняя сетка (≥992px) .col-md-*
Большая сетка (≥1200px) .col-lg-*
Отзывчивые служебные классы (≥1200px) .visible-lg .hidden-lg
Смещения .col-sm-offset-* .col-md-offset-* .col-lg-offset-*
Толкать .col-sm-push-* .col-md-push-* .col-lg-push-*
Вытащить .col-sm-pull-* .col-md-pull-* .col-lg-pull-*
Введите размеры высоты .input-sm .input-lg
Входные группы .input-group .input-group-addon .input-group-btn
Элементы управления формой .form-control .form-group
Размеры группы кнопок .btn-group-xs .btn-group-sm .btn-group-lg
Текст навигации .navbar-text
Заголовок панели навигации .navbar-header
Оправданные вкладки / таблетки .nav-justified
Адаптивные изображения .img-responsive
Строки контекстной таблицы .success .danger .warning .active .info
Контекстные панели .panel-success .panel-danger .panel-warning .panel-info
Модальный .modal-dialog .modal-content
Уменьшенное изображение .img-thumbnail
Размеры скважин .well-sm .well-lg
Ссылки оповещений .alert-link

Что удалено

Следующие элементы были исключены или изменены в версии 3.0.

Элемент Удалено из 2.x 3.0 Эквивалент
Действия формы .form-actions Н/Д
Форма поиска .form-search Н/Д
Форма группы с информацией .control-group.info Н/Д
Размеры ввода фиксированной ширины .input-mini .input-small .input-medium .input-large .input-xlarge .input-xxlarge Вместо этого используйте сетку.form-control .
Ввод формы на уровне блока .input-block-level Прямого эквивалента нет, но формы управления аналогичны.
Инверсные кнопки .btn-inverse Н/Д
Жидкий ряд .row-fluid .row(больше нет фиксированной сетки)
Обертка элементов управления .controls Н/Д
Ряд элементов управления .controls-row .rowили же.form-group
Навбар внутренний .navbar-inner Н/Д
Вертикальные разделители навигации .navbar .divider-vertical Н/Д
Выпадающее подменю .dropdown-submenu Н/Д
Выравнивание вкладок .tabs-left .tabs-right .tabs-below Н/Д
Область вкладок на основе таблеток .pill-content .tab-content
Область вкладок на основе таблеток .pill-pane .tab-pane
Списки навигации .nav-list .nav-header Нет прямого эквивалента, но группы списков и .panel-groups похожи.
Встроенная справка для элементов управления формы .help-inline Нет точного эквивалента, но .help-blockпохож.
Цвета прогресса не на уровне столбцов .progress-info .progress-success .progress-warning .progress-danger Используйте вместо этого .progress-bar-*..progress-bar

Дополнительные примечания

Другие изменения в версии 3.0 не сразу бросаются в глаза. Базовые классы, ключевые стили и поведение были скорректированы для гибкости и нашего подхода Mobile First. Вот неполный список:

  • По умолчанию текстовые элементы управления формы теперь получают только минимальный стиль. Для фокусных цветов и закругленных углов примените .form-controlкласс элемента к стилю.
  • Текстовые элементы управления формы с .form-controlпримененным классом теперь по умолчанию имеют ширину 100%. Оберните входные данные внутри <div class="col-*"></div>, чтобы контролировать ширину входных данных.
  • .badgeбольше не имеет контекстных (-success,-primary и т. д.) классов.
  • .btnтакже необходимо использовать .btn-default, чтобы получить кнопку «по умолчанию».
  • .rowтеперь жидкий.
  • Изображения больше не реагируют по умолчанию. Используйте для размера .img-responsiveжидкости .<img>
  • Значки теперь .glyphiconоснованы на шрифтах. Для значков также требуется базовый класс и класс значков (например, .glyphicon .glyphicon-asterisk).
  • От Typeahead отказались в пользу использования Twitter Typeahead .
  • Модальная разметка существенно изменилась. Разделы .modal-header, .modal-bodyи .modal-footerтеперь заключены в .modal-contentи .modal-dialogдля улучшения стиля и поведения мобильных устройств. Кроме того, вы больше не должны применять .hideв .modalсвоей разметке.
  • Начиная с версии 3.1.0, HTML-код, загружаемый remoteмодальной опцией, теперь вставляется в .modal-content(с версии 3.0.0 до версии 3.0.3, в файл .modal) вместо файла .modal-body. Это позволяет вам также легко изменять верхний и нижний колонтитулы модального окна, а не только тело модального окна.
  • Функции флажка и переключателя плагина button.js теперь используются data-toggle="buttons"вместо data-toggle="buttons-checkbox"или data-toggle="buttons-radio"в их разметке.
  • События JavaScript имеют пространство имен. Например, для обработки модального события "show" используйте 'show.bs.modal'. Для "показанных" вкладок используйте 'shown.bs.tab'и т.д.

Дополнительные сведения об обновлении до версии 3.0 и фрагменты кода от сообщества см . в разделе Bootply .