ย้ายจาก 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 Use .form-control and the grid system instead.
Block level form input .input-block-level No direct equivalent, but forms controls are similar.
Inverse buttons .btn-inverse N/A
Fluid row .row-fluid .row (no more fixed grid)
Controls wrapper .controls N/A
Controls row .controls-row .row or .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 No direct equivalent, but list groups and .panel-groups are similar.
Inline help for form controls .help-inline No exact equivalent, but .help-block is similar.
Non-bar-level progress colors .progress-info .progress-success .progress-warning .progress-danger Use .progress-bar-* on the .progress-bar instead.

หมายเหตุเพิ่มเติม

การเปลี่ยนแปลงอื่น ๆ ใน v3.0 ไม่ชัดเจนทันที คลาสพื้นฐาน สไตล์สำคัญ และพฤติกรรมได้รับการปรับเปลี่ยนเพื่อความยืดหยุ่นและแนวทาง มือถุก่อน ของเรา นี่คือรายการบางส่วน:

  • โดยค่าเริ่มต้น ควบคุมฟอร์มที่ใช้ข้อความตอนนี้จะได้รับการออกแบบเพียงเล็กน้อย สำหรับสีโฟกัสและมุมโค้ง ใช้คลาส .form-control บนองค์ประกอบเพื่อออกแบบ
  • ควบคุมฟอร์มที่ใช้ข้อความที่ใช้คลาส .form-control ตอนนี้กว้าง 100% โดยค่าเริ่มต้น ห่ออินพุตภายใน <div class="col-*"></div> เพื่อควบคุมความกว้างของอินพุต
  • .badge ไม่มีคลาสบริบท (-success,-primary,etc..) อีกต่อไป
  • .btn ต้องใช้ .btn-default ด้วยเพื่อรับปุ่ม "default"
  • .row ตอนนี้เป็น fluid
  • รูปภาพไม่ใช่ตัวตอบสนองโดยค่าเริ่มต้นแล้ว ใช้ .img-responsive สำหรับขนาด <img> ที่ fluid
  • ไอคอน ซึ่งตอนนี้เป็น .glyphicon ตอนนี้ใช้แบบฟอนต์ ไอคอนยังต้องใช้คลาสพื้นฐานและไอคอน (เช่น .glyphicon .glyphicon-asterisk)
  • Typeahead ถูกลบออก เนื่องจากใช้ Twitter Typeahead แทน
  • Modal markup ได้เปลี่ยนแปลงอย่างมาก ส่วน .modal-header, .modal-body, และ .modal-footer ตอนนี้ถูกห่อใน .modal-content และ .modal-dialog เพื่อการออกแบบและพฤติกรรมบนมือถือที่ดีขึ้น นอกจากนี้ คุณไม่ควรใช้ .hide กับ .modal ใน markup ของคุณอีกต่อไป
  • ตั้งแต่ v3.1.0 HTML ที่โหลดโดยตัวเลือก modal remote ตอนนี้ถูกฉีดเข้าไปใน .modal-content (จาก v3.0.0 ถึง v3.0.3 เข้าไปใน .modal) แทนที่จะเข้าไปใน .modal-body นี้ช่วยให้คุณสามารถเปลี่ยนส่วนหัวและส่วนท้ายของ modal ได้ง่ายขึ้นไม่เพียงแต่เนื้อหาของ modal เท่านั้น
  • คุณสมบัติ checkbox และ radio ของปลั๊กอิน button.js ตอนนี้ทั้งคู่ใช้ data-toggle="buttons" แทน data-toggle="buttons-checkbox" หรือ data-toggle="buttons-radio" ใน markup ของพวกเขา
  • เหตุการณ์ JavaScript มีชื่อสเปซ ตัวอย่างเช่น เพื่อจัดการเหตุการณ์ "show" ของ modal ใช้ 'show.bs.modal' สำหรับแท็บ "shown" ใช้ 'shown.bs.tab' เป็นต้น

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการอัปเกรดไปยัง v3.0 และรหัสส่วนย่อยจากชุมชน ดู Bootply