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

Bootstrap 3 не обратно совместим с v2.x. Используйте этот раздел как общее руководство для обновления с v2.x на v3.0. Для более широкого обзора см. что нового в объявлении о выпуске v3.0.

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

Эта таблица показывает изменения стилей между v2.x и v3.0.

Bootstrap 2.x Bootstrap 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
Glyphicons .glyphicon
Jumbotron .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-*
Push .col-sm-push-* .col-md-push-* .col-lg-push-*
Pull .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 .well-sm .well-lg
Ссылки предупреждений .alert-link

Что удалено

Следующие элементы были удалены или изменены в v3.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 Н/Д
Fluid row .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 вместо этого.

Дополнительные заметки

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

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

Для получения дополнительной информации об обновлении до v3.0 и фрагментов кода от сообщества см. Bootply.