2.x から 3.0 への移行

Bootstrap 3 は v2.x との互換性がありません。v2.x から v3.0 へのアップグレードの一般的なガイドとしてこのセクションを使用してください。より広範な概要については、v3.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 Split into .visible-md .visible-lg
.hidden-phone .hidden-xs
.hidden-tablet .hidden-sm
.hidden-desktop Split into .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

新機能

新しい要素を追加し、既存の要素の一部を変更しました。以下は新しいまたは更新されたスタイルです。

要素 説明
Panels .panel .panel-default .panel-body .panel-title .panel-heading .panel-footer .panel-collapse
List groups .list-group .list-group-item .list-group-item-text .list-group-item-heading
Glyphicons .glyphicon
Jumbotron .jumbotron
Extra small grid (<768px) .col-xs-*
Small grid (≥768px) .col-sm-*
Medium grid (≥992px) .col-md-*
Large grid (≥1200px) .col-lg-*
Responsive utility classes (≥1200px) .visible-lg .hidden-lg
Offsets .col-sm-offset-* .col-md-offset-* .col-lg-offset-*
Push .col-sm-push-* .col-md-push-* .col-lg-push-*
Pull .col-sm-pull-* .col-md-pull-* .col-lg-pull-*
Input height sizes .input-sm .input-lg
Input groups .input-group .input-group-addon .input-group-btn
Form controls .form-control .form-group
Button group sizes .btn-group-xs .btn-group-sm .btn-group-lg
Navbar text .navbar-text
Navbar header .navbar-header
Justified tabs / pills .nav-justified
Responsive images .img-responsive
Contextual table rows .success .danger .warning .active .info
Contextual panels .panel-success .panel-danger .panel-warning .panel-info
Modal .modal-dialog .modal-content
Thumbnail image .img-thumbnail
Well sizes .well-sm .well-lg
Alert links .alert-link

削除された機能

以下の要素は v3.0 で削除または変更されました。

要素 2.x から削除 3.0 の同等物
Form actions .form-actions N/A
Search form .form-search N/A
Form group with info .control-group.info N/A
Fixed-width input sizes .input-mini .input-small .input-medium .input-large .input-xlarge .input-xxlarge 代わりに .form-control と グリッドシステム を使用してください。
Block level form input .input-block-level 直接の同等物はありませんが、フォームコントロール が似ています。
Inverse buttons .btn-inverse N/A
Fluid row .row-fluid .row (固定グリッドはなくなりました)
Controls wrapper .controls N/A
Controls row .controls-row .row または .form-group
Navbar inner .navbar-inner N/A
Navbar vertical dividers .navbar .divider-vertical N/A
Dropdown submenu .dropdown-submenu N/A
Tab alignments .tabs-left .tabs-right .tabs-below N/A
Pill-based tabbable area .pill-content .tab-content
Pill-based tabbable area pane .pill-pane .tab-pane
Nav lists .nav-list .nav-header 直接の同等物はありませんが、リストグループ と .panel-group が似ています。
Inline help for form controls .help-inline 正確な同等物はありませんが、.help-block が似ています。
Non-bar-level progress colors .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> サイズには .img-responsive を使用してください。
  • アイコンは、今や .glyphicon で、フォントベースになりました。アイコンには、ベースクラスとアイコンクラスの両方が必要です (例: .glyphicon .glyphicon-asterisk)。
  • Typeahead は、Twitter Typeahead の使用に有利になるため、削除されました。
  • モーダルのマークアップは大幅に変更されました。.modal-header、.modal-body、.modal-footer セクションは、より良いモバイルスタイルと動作のために .modal-content と .modal-dialog にラップされるようになりました。また、マークアップで .modal に .hide を適用する必要はもうありません。
  • v3.1.0 以降、remote モーダルオプションによって読み込まれる HTML は、.modal-body ではなく .modal-content (v3.0.0 から v3.0.3 では .modal に) に挿入されるようになりました。これにより、モーダルの本文だけでなく、ヘッダーとフッターも簡単に変更できるようになります。
  • button.js プラグインのチェックボックスとラジオ機能は、マークアップで data-toggle="buttons-checkbox" や data-toggle="buttons-radio" の代わりに data-toggle="buttons" を使用するようになりました。
  • JavaScript イベントは名前空間が設定されています。たとえば、モーダルの "show" イベントを処理するには、'show.bs.modal' を使用します。タブの "shown" イベントには、'shown.bs.tab' などを使用します。

v3.0 へのアップグレードに関する詳細情報と、コミュニティからのコードスニペットについては、Bootply を参照してください。