Migrando de 2.x para 3.0

O Bootstrap 3 não é compatível com a versão 2.x. Use esta seção como um guia geral para atualizar de v2.x para v3.0. Para uma visão geral mais ampla, veja o que há de novo no anúncio de lançamento da v3.0.

Principais mudanças de classe

Esta tabela mostra as mudanças de estilo entre v2.xe 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 em.visible-md .visible-lg
.hidden-phone .hidden-xs
.hidden-tablet .hidden-sm
.hidden-desktop Dividir em.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

O que há de novo

Adicionamos novos elementos e alteramos alguns existentes. Aqui estão os estilos novos ou atualizados.

Elemento Descrição
Painéis .panel .panel-default .panel-body .panel-title .panel-heading .panel-footer .panel-collapse
Listar grupos .list-group .list-group-item .list-group-item-text .list-group-item-heading
Glyphicons .glyphicon
Jumbotron .jumbotron
Grade extra pequena (<768px) .col-xs-*
Grade pequena (≥768px) .col-sm-*
Grade média (≥992px) .col-md-*
Grade grande (≥1200px) .col-lg-*
Classes de utilitários responsivos (≥1200px) .visible-lg .hidden-lg
Compensações .col-sm-offset-* .col-md-offset-* .col-lg-offset-*
Empurre .col-sm-push-* .col-md-push-* .col-lg-push-*
Puxar .col-sm-pull-* .col-md-pull-* .col-lg-pull-*
Tamanhos de altura de entrada .input-sm .input-lg
Grupos de entrada .input-group .input-group-addon .input-group-btn
Controles de formulário .form-control .form-group
Tamanhos de grupos de botões .btn-group-xs .btn-group-sm .btn-group-lg
Texto da barra de navegação .navbar-text
Cabeçalho da barra de navegação .navbar-header
Abas/pílulas justificadas .nav-justified
Imagens responsivas .img-responsive
Linhas da tabela contextual .success .danger .warning .active .info
Painéis contextuais .panel-success .panel-danger .panel-warning .panel-info
Modal .modal-dialog .modal-content
Imagem em miniatura .img-thumbnail
Tamanhos de poços .well-sm .well-lg
Links de alerta .alert-link

O que foi removido

Os seguintes elementos foram descartados ou alterados na v3.0.

Elemento Removido de 2.x 3,0 Equivalente
Ações do formulário .form-actions N / D
Formulário de pesquisa .form-search N / D
Grupo de formulários com informações .control-group.info N / D
Tamanhos de entrada de largura fixa .input-mini .input-small .input-medium .input-large .input-xlarge .input-xxlarge Use .form-controle o sistema de grade em vez disso.
Entrada de formulário em nível de bloco .input-block-level Nenhum equivalente direto, mas os controles de formulários são semelhantes.
Botões inversos .btn-inverse N / D
Linha fluida .row-fluid .row(não há mais grade fixa)
Wrapper de controles .controls N / D
Linha de controles .controls-row .rowou.form-group
Barra de navegação interna .navbar-inner N / D
Divisores verticais da barra de navegação .navbar .divider-vertical N / D
Submenu suspenso .dropdown-submenu N / D
Alinhamentos de guias .tabs-left .tabs-right .tabs-below N / D
Área tabbável à base de pílula .pill-content .tab-content
Área de tabulação baseada em pílulas .pill-pane .tab-pane
Listas de navegação .nav-list .nav-header Nenhum equivalente direto, mas grupos de listas e .panel-groups são semelhantes.
Ajuda em linha para controles de formulário .help-inline Sem equivalente exato, mas .help-blocké semelhante.
Cores de progresso não no nível da barra .progress-info .progress-success .progress-warning .progress-danger Use .progress-bar-*no .progress-barlugar.

Notas Adicionais

Outras mudanças na v3.0 não são imediatamente aparentes. As classes básicas, os principais estilos e os comportamentos foram ajustados para flexibilidade e nossa abordagem mobile first . Aqui está uma lista parcial:

  • Por padrão, os controles de formulário baseados em texto agora recebem apenas um estilo mínimo. Para cores de foco e cantos arredondados, aplique a .form-controlclasse no elemento ao estilo.
  • Os controles de formulário baseados em texto com a .form-controlclasse aplicada agora têm 100% de largura por padrão. Envolva as entradas <div class="col-*"></div>para controlar as larguras de entrada.
  • .badgenão tem mais classes contextuais (-success,-primary, etc.).
  • .btntambém deve usar .btn-defaultpara obter o botão "padrão".
  • .rowagora é fluido.
  • As imagens não são mais responsivas por padrão. Use .img-responsivepara o tamanho do fluido <img>.
  • Os ícones, agora .glyphicon, agora são baseados em fontes. Os ícones também requerem uma classe base e de ícones (por exemplo .glyphicon .glyphicon-asterisk, ).
  • Typeahead foi descartado, em favor do uso do Twitter Typeahead .
  • A marcação modal mudou significativamente. As seções , e agora estão agrupadas .modal-headere .modal-bodypara melhor estilo e comportamento móvel. Além disso, você não deve mais aplicar em sua marcação..modal-footer.modal-content.modal-dialog.hide.modal
  • A partir da v3.1.0, o HTML carregado pela remoteopção modal agora é injetado no .modal-content(de v3.0.0 para v3.0.3, no .modal) em vez de no .modal-body. Isso permite que você também varie facilmente o cabeçalho e o rodapé do modal, não apenas o corpo do modal.
  • Os recursos de caixa de seleção e rádio do plug-in button.js agora usam data-toggle="buttons"em vez de data-toggle="buttons-checkbox"ou data-toggle="buttons-radio"em sua marcação.
  • Os eventos JavaScript são namespaced. Por exemplo, para manipular o evento modal "show", use 'show.bs.modal'. Para guias "exibidas", use 'shown.bs.tab', etc.

Para obter mais informações sobre como atualizar para a v3.0 e trechos de código da comunidade, consulte Bootply .