Migrando para v3.x
Orientação sobre como atualizar do Bootstrap v2.x para v3.x com ênfase nas principais mudanças, o que há de novo e o que foi removido.
Orientação sobre como atualizar do Bootstrap v2.x para v3.x com ênfase nas principais mudanças, o que há de novo e o que foi removido.
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.
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 |
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 |
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-control e 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 |
.row ou.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-group s 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-bar lugar. |
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:
.form-control
classe no elemento ao estilo..form-control
classe aplicada agora têm 100% de largura por padrão. Envolva as entradas <div class="col-*"></div>
para controlar as larguras de entrada..badge
não tem mais classes contextuais (-success,-primary, etc.)..btn
também deve usar .btn-default
para obter o botão "padrão"..row
agora é fluido..img-responsive
para o tamanho do fluido <img>
..glyphicon
, agora são baseados em fontes. Os ícones também requerem uma classe base e de ícones (por exemplo .glyphicon .glyphicon-asterisk
, )..modal-header
e .modal-body
para 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
remote
opçã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.data-toggle="buttons"
em vez de data-toggle="buttons-checkbox"
ou data-toggle="buttons-radio"
em sua marcação.'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 .