Migracja z wersji 2.x do 3.0

Bootstrap 3 nie jest wstecznie kompatybilny z v2.x. Użyj tej sekcji jako ogólnego przewodnika po uaktualnieniu z wersji 2.x do wersji 3.0. Aby uzyskać szerszy przegląd, zobacz, co nowego w ogłoszeniu o wersji v3.0.

Główne zmiany klasowe

Ta tabela przedstawia zmiany stylu między wersjami 2.x i 3.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 Podzielony na.visible-md .visible-lg
.hidden-phone .hidden-xs
.hidden-tablet .hidden-sm
.hidden-desktop Podzielony na.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

Co nowego

Dodaliśmy nowe elementy i zmieniliśmy niektóre istniejące. Oto nowe lub zaktualizowane style.

Element Opis
Panele .panel .panel-default .panel-body .panel-title .panel-heading .panel-footer .panel-collapse
Lista grup .list-group .list-group-item .list-group-item-text .list-group-item-heading
Glify .glyphicon
Jumbotron .jumbotron
Bardzo mała siatka (<768px) .col-xs-*
Mała siatka (≥768px) .col-sm-*
Średnia siatka (≥992px) .col-md-*
Duża siatka (≥1200px) .col-lg-*
Responsywne klasy użyteczności (≥1200px) .visible-lg .hidden-lg
Przesunięcia .col-sm-offset-* .col-md-offset-* .col-lg-offset-*
Naciskać .col-sm-push-* .col-md-push-* .col-lg-push-*
Ciągnąć .col-sm-pull-* .col-md-pull-* .col-lg-pull-*
Wprowadź rozmiary wysokości .input-sm .input-lg
Grupy wejściowe .input-group .input-group-addon .input-group-btn
Kontrolki formularzy .form-control .form-group
Rozmiary grup przycisków .btn-group-xs .btn-group-sm .btn-group-lg
Tekst paska nawigacyjnego .navbar-text
Nagłówek paska nawigacyjnego .navbar-header
Uzasadnione tabletki / pigułki .nav-justified
Responsywne obrazy .img-responsive
Wiersze tabeli kontekstowej .success .danger .warning .active .info
Panele kontekstowe .panel-success .panel-danger .panel-warning .panel-info
Modalny .modal-dialog .modal-content
Miniatura .img-thumbnail
Dobrze rozmiary .well-sm .well-lg
Linki do alertów .alert-link

Co zostało usunięte

Następujące elementy zostały usunięte lub zmienione w wersji 3.0.

Element Usunięto z 2.x 3.0 odpowiednik
Akcje formularza .form-actions Nie dotyczy
Formularz wyszukiwania .form-search Nie dotyczy
Utwórz grupę z informacjami .control-group.info Nie dotyczy
Rozmiary wejściowe o stałej szerokości .input-mini .input-small .input-medium .input-large .input-xlarge .input-xxlarge Zamiast tego użyj .form-controlsystemu siatki .
Wejście formularza na poziomie bloku .input-block-level Brak bezpośredniego odpowiednika, ale kontrolki formularzy są podobne.
Przyciski odwrotne .btn-inverse Nie dotyczy
Płynny rząd .row-fluid .row(nie więcej stałej siatki)
Opakowania kontroli .controls Nie dotyczy
Wiersz kontroli .controls-row .rowlub.form-group
Wewnętrzny pasek nawigacyjny .navbar-inner Nie dotyczy
Przegrody pionowe paska nawigacyjnego .navbar .divider-vertical Nie dotyczy
Rozwijane podmenu .dropdown-submenu Nie dotyczy
Wyrównania zakładek .tabs-left .tabs-right .tabs-below Nie dotyczy
Obszar tabbable oparty na pigułkach .pill-content .tab-content
Okienko obszaru z zakładkami oparte na pigułkach .pill-pane .tab-pane
Listy nawigacyjne .nav-list .nav-header Brak bezpośredniego odpowiednika, ale grupy list i .panel-groups są podobne.
Pomoc inline dla kontrolek formularzy .help-inline Brak dokładnego odpowiednika, ale .help-blockjest podobny.
Kolory postępu inne niż na poziomie paska .progress-info .progress-success .progress-warning .progress-danger Użyj .progress-bar-*na .progress-barzamiast.

Dodatkowe uwagi

Inne zmiany w wersji 3.0 nie są od razu widoczne. Klasy podstawowe, kluczowe style i zachowania zostały dostosowane pod kątem elastyczności i naszego podejścia mobile first . Oto częściowa lista:

  • Domyślnie kontrolki formularzy tekstowych otrzymują teraz tylko minimalną stylizację. W przypadku kolorów ostrości i zaokrąglonych rogów zastosuj .form-controlklasę do elementu, aby nadać mu styl.
  • Kontrolki formularzy tekstowych z .form-controlzastosowaną klasą mają teraz domyślnie szerokość 100%. Zawijaj dane wejściowe wewnątrz <div class="col-*"></div>, aby sterować szerokościami wejściowymi.
  • .badgenie ma już klas kontekstowych (-success,-primary, etc.).
  • .btnnależy również użyć .btn-default, aby uzyskać przycisk "domyślny".
  • .rowjest teraz płynny.
  • Obrazy nie są już domyślnie responsywne. Użyj do wielkości .img-responsivepłynu .<img>
  • Ikony, teraz .glyphicon, są teraz oparte na czcionce. Ikony wymagają również bazy i klasy ikon (np .glyphicon .glyphicon-asterisk. ).
  • Typeahead został porzucony na rzecz korzystania z Twittera Typeahead .
  • Znacznie zmieniły się znaczniki modalne. Sekcje .modal-header, .modal-bodyi .modal-footersą teraz otoczone .modal-contenti .modal-dialogdla lepszego stylu i zachowania na urządzeniach mobilnych. Ponadto nie powinieneś już stosować .hidew .modalswoich znacznikach.
  • Od wersji 3.1.0 HTML załadowany przez remoteopcję modalną jest teraz wstrzykiwany do .modal-content(od wersji 3.0.0 do wersji 3.0.3, do .modal) zamiast do .modal-body. Pozwala to również łatwo zmieniać nagłówek i stopkę modalnego, a nie tylko treść modalną.
  • Funkcje pola wyboru i opcji radiowej wtyczki button.js są teraz używane data-toggle="buttons"zamiast data-toggle="buttons-checkbox"lub data-toggle="buttons-radio"w ich znacznikach.
  • Zdarzenia JavaScript mają przestrzeń nazw. Na przykład, aby obsłużyć modalne zdarzenie „show”, użyj 'show.bs.modal'. Dla zakładek „pokazanych” użyj 'shown.bs.tab'itd.

Aby uzyskać więcej informacji na temat uaktualniania do wersji 3.0 i fragmentów kodu ze społeczności, zobacz Bootply .