Migració de 2.x a 3.0

Bootstrap 3 no és compatible cap enrere amb v2.x. Utilitzeu aquesta secció com a guia general per actualitzar de v2.x a v3.0. Per obtenir una visió general més àmplia, vegeu les novetats de l'anunci de llançament de la v3.0.

Canvis importants de classe

Aquesta taula mostra els canvis d'estil entre v2.x i 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 Dividir en.visible-md .visible-lg
.hidden-phone .hidden-xs
.hidden-tablet .hidden-sm
.hidden-desktop Dividir en.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

Que hi ha de nou

Hem afegit elements nous i hem canviat alguns dels existents. Aquí teniu els estils nous o actualitzats.

Element Descripció
Panells .panel .panel-default .panel-body .panel-title .panel-heading .panel-footer .panel-collapse
Llista de grups .list-group .list-group-item .list-group-item-text .list-group-item-heading
Glificons .glyphicon
Jumbotron .jumbotron
Quadrícula extra petita (<768 px) .col-xs-*
Quadrícula petita (≥768 px) .col-sm-*
Quadrícula mitjana (≥992 px) .col-md-*
Quadrícula gran (≥1200 px) .col-lg-*
Classes d'utilitat responsives (≥1200px) .visible-lg .hidden-lg
Desplaçaments .col-sm-offset-* .col-md-offset-* .col-lg-offset-*
Empènyer .col-sm-push-* .col-md-push-* .col-lg-push-*
Estirar .col-sm-pull-* .col-md-pull-* .col-lg-pull-*
Mides d'alçada d'entrada .input-sm .input-lg
Grups d'entrada .input-group .input-group-addon .input-group-btn
Controls de formulari .form-control .form-group
Mides dels grups de botons .btn-group-xs .btn-group-sm .btn-group-lg
Text de la barra de navegació .navbar-text
Capçalera de la barra de navegació .navbar-header
Pestanyes / pastilles justificades .nav-justified
Imatges sensibles .img-responsive
Files de taula contextuals .success .danger .warning .active .info
Panells contextuals .panel-success .panel-danger .panel-warning .panel-info
Modal .modal-dialog .modal-content
Imatge en miniatura .img-thumbnail
Ben mides .well-sm .well-lg
Enllaços d'alerta .alert-link

El que s'ha eliminat

Els elements següents s'han eliminat o canviat a la v3.0.

Element S'ha eliminat de 2.x 3.0 Equivalent
Forma accions .form-actions N/A
Formulari de cerca .form-search N/A
Forma grup amb informació .control-group.info N/A
Mides d'entrada d'amplada fixa .input-mini .input-small .input-medium .input-large .input-xlarge .input-xxlarge Utilitzeu .form-controli el sistema de graella .
Entrada de formulari a nivell de bloc .input-block-level No hi ha cap equivalent directe, però els controls de formularis són similars.
Botons inversos .btn-inverse N/A
Fila de fluids .row-fluid .row(no més quadrícula fixa)
Embolcall de controls .controls N/A
Fila de controls .controls-row .rowo.form-group
Navbar interior .navbar-inner N/A
Divisors verticals de la barra de navegació .navbar .divider-vertical N/A
Submenú desplegable .dropdown-submenu N/A
Alineacions de pestanyes .tabs-left .tabs-right .tabs-below N/A
Àrea de tabulació basada en píndoles .pill-content .tab-content
Panell d'àrea de tabulació basat en píndoles .pill-pane .tab-pane
Llistes de navegació .nav-list .nav-header No hi ha cap equivalent directe, però els grups de llista i .panel-groups són similars.
Ajuda en línia per als controls de formulari .help-inline No és equivalent exacte, però .help-blockés similar.
Colors de progrés que no són a nivell de barra .progress-info .progress-success .progress-warning .progress-danger Feu servir .progress-bar-*en el .progress-barseu lloc.

Notes addicionals

Altres canvis a la v3.0 no són immediatament evidents. Les classes base, els estils clau i els comportaments s'han ajustat per a la flexibilitat i el nostre primer enfocament mòbil . Aquí teniu una llista parcial:

  • De manera predeterminada, els controls de formulari basats en text ara només reben un estil mínim. Per als colors del focus i les cantonades arrodonides, apliqueu la .form-controlclasse a l'element a l'estil.
  • Els controls de formulari basats en text amb la .form-controlclasse aplicada són ara 100% amples per defecte. Embolica les entrades a l'interior <div class="col-*"></div>per controlar l'amplada d'entrada.
  • .badgeja no té classes contextuals (-èxit,-primàries, etc.).
  • .btntambé s'ha d'utilitzar .btn-defaultper obtenir el botó "per defecte".
  • .rowara és fluid.
  • Les imatges ja no responen per defecte. Utilitzeu .img-responsive-lo per a mida de fluid <img>.
  • Les icones, ara .glyphicon, es basen ara en tipus de lletra. Les icones també requereixen una base i una classe d'icones (p. ex .glyphicon .glyphicon-asterisk. ).
  • S'ha eliminat Typeahead, a favor de l'ús de Twitter Typeahead .
  • El marcatge modal ha canviat significativament. Les seccions .modal-header, .modal-body, i .modal-footerara estan embolicats .modal-contenti .modal-dialogper millorar l'estil i el comportament dels mòbils. A més, ja no hauríeu d'aplicar .hideal .modalvostre marcatge.
  • A partir de la v3.1.0, l'HTML carregat per l' remoteopció modal ara s'injecta al .modal-contentfitxer (de la v3.0.0 a la v3.0.3, al fitxer .modal) en lloc de al fitxer .modal-body. Això us permet també variar fàcilment la capçalera i el peu de pàgina del modal, no només el cos modal.
  • La casella de selecció i les funcions de ràdio del connector button.js ara s'utilitzen data-toggle="buttons"en lloc data-toggle="buttons-checkbox"o data-toggle="buttons-radio"en el seu marcatge.
  • Els esdeveniments de JavaScript tenen espai de noms. Per exemple, per gestionar l'esdeveniment modal "mostrar", utilitzeu 'show.bs.modal'. Per a les pestanyes "mostrades", utilitzeu 'shown.bs.tab', etc.

Per obtenir més informació sobre l'actualització a la v3.0 i fragments de codi de la comunitat, vegeu Bootply .