💡Lỗi hay gặp khi dùng Bootstrap
Khi dùng Bootstrap, đặc biệt là các phiên bản phổ biến như 4 hoặc 5, có một số lỗi thường gặp mà nhiều dev hay vấp phải.
Dưới đây là tổng hợp chi tiết kèm nguyên nhân và cách khắc phục:
1️⃣ CSS hoặc JS không hoạt động
Triệu chứng: Các class của Bootstrap không áp dụng được, các component như modal, dropdown không chạy.
Nguyên nhân:
-
Chưa nhúng đúng file CSS hoặc JS.
-
Thứ tự nhúng sai: JS của Bootstrap cần jQuery (với BS4) và Popper.js trước.
-
Phiên bản không tương thích giữa CSS và JS.
Cách khắc phục:
-
Kiểm tra link CDN hoặc file local.
-
Với Bootstrap 4:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.6.2/dist/css/bootstrap.min.css">
<script src="https://code.jquery.com/jquery-3.6.4.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/popper.js@1.16.1/dist/umd/popper.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@4.6.2/dist/js/bootstrap.min.js"></script>
-
Với Bootstrap 5: không cần jQuery, chỉ cần Popper nếu dùng tooltip/popover.
2️⃣ Layout bị “vỡ” hoặc không responsive
Triệu chứng: Grid không đúng, cột không đều, menu mobile không hiện.
Nguyên nhân:
-
Không dùng
.containerhoặc.rowđúng cách. -
Quên
col-*hoặc mix lẫn grid cũ/ mới. -
Dùng container cứng thay vì container-fluid khi cần.
Cách khắc phục:
-
Luôn bọc
.rowtrong.containerhoặc.container-fluid. -
Cột phải đặt class
col-*cụ thể.
<div class="container">
<div class="row">
<div class="col-md-6">Cột 1</div>
<div class="col-md-6">Cột 2</div>
</div>
</div>
3️⃣ Modal, dropdown, collapse không hoạt động
Triệu chứng: Click button nhưng modal không mở hoặc collapse không bung ra.
Nguyên nhân:
-
Quên nhúng JS hoặc nhúng sai thứ tự.
-
Bootstrap 5: sử dụng
data-togglethay vìdata-bs-toggle. -
JS bị lỗi từ script khác gây cản trở.
Cách khắc phục:
-
Dùng đúng attribute:
-
BS4:
data-toggle="modal" -
BS5:
data-bs-toggle="modal"
-
4️⃣ Z-index hoặc hiển thị bị lỗi
Triệu chứng: Dropdown, modal bị che bởi các phần tử khác.
Nguyên nhân: CSS custom override hoặc container có overflow: hidden hoặc position: relative.
Cách khắc phục:
-
Kiểm tra CSS override.
-
Với modal hoặc dropdown, đặt
positionvàz-indexđúng. -
Sử dụng
.modalhoặc.dropdown-menucủa Bootstrap chuẩn.
5️⃣ Không update icon / image đúng kích thước
Triệu chứng: Image vượt quá container, icon không đúng.
Nguyên nhân:
-
Quên class responsive
.img-fluid. -
Icon cũ, fontawesome chưa nhúng.
Cách khắc phục:
<img src="image.jpg" class="img-fluid" alt="Responsive image">
6️⃣ Conflicting CSS với framework khác
Triệu chứng: Styling Bootstrap bị lỗi khi dùng với Tailwind, Material, hoặc CSS riêng.
Nguyên nhân: Class trùng tên hoặc reset CSS khác.
Cách khắc phục:
-
Dùng namespace cho CSS custom.
-
Kiểm tra thứ tự import CSS (Bootstrap trước custom).
7️⃣ Version mismatch
Triệu chứng: Code Bootstrap cũ không chạy trên BS5, hoặc ngược lại.
Nguyên nhân: Component hoặc class đã bị đổi tên (ví dụ: .ml-auto → .ms-auto).
Cách khắc phục: Luôn kiểm tra migration guide khi nâng cấp Bootstrap.
💡 Tip chung:
-
Dùng DevTools để kiểm tra class và console JS lỗi.
-
Đọc kỹ tài liệu Bootstrap theo version bạn đang dùng.
-
Tránh copy-paste code cũ nếu nâng version Bootstrap.
Nếu muốn, tôi có thể làm cho bạn bảng checklist 15 lỗi Bootstrap hay gặp kèm code mẫu khắc phục, dễ tra cứu khi lập trình.
✨ made by AI
Nhận xét
Đăng nhận xét