Мигриране от 2.x към 3.0

Bootstrap 3 не е обратно съвместим с v2.x. Използвайте този раздел като общо ръководство за надграждане от v2.x до v3.0. За по-широк преглед вижте какво е новото в съобщението за версия 3.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
Глификони .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

Какво е премахнато

Следните елементи са премахнати или променени във v3.0.

елемент Премахнато от 2.x 3.0 еквивалент
Действия на формата .form-actions N/A
Форма за търсене .form-search N/A
Формирайте група с информация .control-group.info N/A
Входни размери с фиксирана ширина .input-mini .input-small .input-medium .input-large .input-xlarge .input-xxlarge Вместо това използвайте .form-controlи мрежовата система .
Въвеждане на формуляр на ниво блок .input-block-level Няма пряк еквивалент, но контролите на формулярите са подобни.
Инверсни копчета .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-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 не са очевидни веднага. Базовите класове, ключовите стилове и поведението са коригирани за гъвкавост и нашия подход на първо място за мобилни устройства . Ето частичен списък:

  • По подразбиране текстовите контроли на формуляри вече получават само минимален стил. За цветове на фокуса и заоблени ъгли, приложете .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във вашата маркировка.
  • От 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.bs.tab'и т.н.

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