Переход на v3.x
Руководство по обновлению Bootstrap, что нового, и что было удалено.
Переход с версии 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 |
.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-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 | .jumbotron |
| Очень маленькая сетка (<768px) | .col-xs-* |
| Small grid (≥768px) | .col-sm-* |
| Medium grid (≥992px) | .col-md-* |
| Large grid (≥1200px) | .col-lg-* |
| Responsive utility classes (≥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 height sizes | .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 |
| Выравнивание вкладки / кнопки (pills) | .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 |
Что удалено
Следующие элементы были удалены или изменены в v3.0.
| Элемент | Удалено из 2.x | 3.0 Эквивалент |
|---|---|---|
| Действие формы | .form-actions | N/A |
| Форма поиска | .form-search | N/A |
| Группа информационных форм | .control-group.info | N/A |
| Fixed-width input sizes | .input-mini.input-small.input-medium.input-large.input-xlarge.input-xxlarge | Use .form-control and the grid system instead. |
| Block level form input | .input-block-level | No direct equivalent, but forms controls are similar. |
| Inverse buttons | .btn-inverse | N/A |
| Тягучая строка | .row-fluid | .row (больше нет фиксированной сетки) |
| Обертка управления | .controls | N/A |
| Панель управления | .controls-row | .row или .form-group |
| Родное нав.меню | .navbar-inner | N/A |
| Драйвер вертикального нав.меню | .navbar .divider-vertical | N/A |
| Ниспадающее меню | .dropdown-submenu | N/A |
| Выравнивание вкладки | .tabs-left - .tabs-right - .tabs-below | N/A |
| Pill-based tabbable area | .pill-content | .tab-content |
| Pill-based tabbable area pane | .pill-pane | .tab-pane |
| Список нав.меню | .nav-list - .nav-header | Нет точного эквивалента, но список групп и .panel-group являются схожими. |
| Inline help for form controls | .help-inline | No exact equivalent, but .help-block is similar. |
Дополнительные примечания
Другие изменения в v3.0 не столь очевидны. Базовые классы, основные стили поведения были скорректированы для гибкости и нашего подхода в первую очередь для мобильных устройств. Вот неполный список:
- По умолчанию текстовые элементы управления формы теперь получают минимальный стиль. Для управления цветом фокуса и закругленными углами применяйте класс
.form-control. - Текстовые элементы управления формы с классом
.form-controlтеперь по умолчанию имеют ширину со значением 100%. Вкладывайте формы ввода в середину<div class="col-*"></div>для управления их шириной. .badgeбольше нет контекстных классов (-success,-primary,и т.д.)..btnдолжен также использовать.btn-default, чтобы создать кнопку по умолчанию..rowis now fluid.- Изображения неадаптивны по умолчанию. Используйте
.img-responsive, для тягучести<img>. - Теперь иконки
.glyphiconбазируются на шрифтах. Иконкам также необходимые базовые и специальные классы (например,.glyphicon .glyphicon-asterisk). - Typeahead было удалено, на пользу Twitter Typeahead.
- Modal markup has changed significantly. The
.modal-header,.modal-body, and.modal-footersections are now wrapped in.modal-contentand.modal-dialogfor better mobile styling and behavior. Also, you should no longer apply.hideto.modalin your markup. - As of v3.1.0, the HTML loaded by the
remotemodal option is now injected into the.modal-content(from v3.0.0 to v3.0.3, into the.modal) instead of into the.modal-body. This allows you to also easily vary the header and footer of the modal, not just the modal body. - JavaScript события имеют пространства имен (namespaced). Например, чтобы обработать событие "show" в модалі, используйте
'show.bs.modal'. Для закладок "shown" используйте'shown.bs.tab', и т.д.
Более подробную информацию о апгрейда до v3.0 смотрите на Bootply, где участники обсуждений преподают также и части кода.