💡Lỗi hay gặp khi dùng AdminLTE
Dưới đây là các lỗi hay gặp khi sử dụng AdminLTE mà Tiến sĩ M có thể gặp phải, kèm giải thích và cách khắc phục:
1️⃣ CSS / JS không load đúng
Triệu chứng: Giao diện “vỡ”, biểu tượng không hiện, sidebar không hoạt động.
Nguyên nhân: Sai đường dẫn file CSS hoặc JS, hoặc tải theo thứ tự sai.
Cách khắc phục:
-
Luôn tải jQuery → Bootstrap → AdminLTE JS.
-
Kiểm tra đường dẫn file: nếu dùng CDN, đảm bảo mạng ổn định; nếu dùng local, kiểm tra đúng folder
pluginsvàdist.
2️⃣ Xung đột jQuery / Bootstrap
Triệu chứng: Tooltip, modal, dropdown không hoạt động.
Nguyên nhân: Dùng nhiều phiên bản jQuery hoặc Bootstrap cùng lúc.
Cách khắc phục:
-
Chỉ giữ 1 phiên bản jQuery.
-
Kiểm tra console xem có lỗi “$.fn.tooltip is not a function” → thường là xung đột jQuery.
3️⃣ Sidebar / Treeview không hoạt động
Triệu chứng: Menu không bung ra khi click.
Nguyên nhân: Chưa khởi tạo AdminLTE layout hoặc thiếu JS.
Cách khắc phục:
$(function () {
$('.sidebar-menu').Treeview(); // hoặc dùng AdminLTE.init()
});
4️⃣ Toastr / SweetAlert không hiện thông báo
Triệu chứng: Gọi toastr hoặc swal nhưng không thấy popup.
Nguyên nhân: Chưa load CSS/JS của plugin, hoặc xung đột với AdminLTE.
Cách khắc phục: Load plugin sau AdminLTE JS, kiểm tra console.
5️⃣ Datatable hiển thị lỗi
Triệu chứng: Bảng không style, nút pagination không hiện.
Nguyên nhân: Thiếu CSS/JS của DataTables, hoặc xung đột theme AdminLTE.
Cách khắc phục:
-
Load
datatables.min.cssvàdatatables.min.js. -
Nếu dùng Bootstrap theme: load
dataTables.bootstrap5.min.css/js.
6️⃣ Layout không responsive
Triệu chứng: Mobile view hiển thị sai, sidebar che mất nội dung.
Nguyên nhân: Thiếu meta viewport hoặc dùng container sai.
Cách khắc phục:
<meta name="viewport" content="width=device-width, initial-scale=1">
-
Sử dụng đúng class
container,container-fluid,row,col-*.
7️⃣ Icon không hiển thị
Triệu chứng: <i class="fas fa-user"></i> chỉ hiện ô vuông.
Nguyên nhân: Font Awesome chưa load, hoặc load phiên bản sai.
Cách khắc phục: Load đúng CDN hoặc file CSS Font Awesome tương thích AdminLTE version.
8️⃣ Lỗi khi cập nhật AdminLTE
Triệu chứng: Một số plugin hoặc script trước đó không hoạt động.
Nguyên nhân: AdminLTE version mới thay đổi API, class, hoặc file JS.
Cách khắc phục: Đọc changelog, điều chỉnh code tương thích.
💡 Tip chung:
-
Luôn kiểm tra console (
F12) để biết lỗi JS / CSS. -
Tạo project mẫu với AdminLTE vanilla trước, sau đó mới tùy chỉnh.
Nếu Tiến sĩ M muốn, tôi có thể làm luôn bảng tổng hợp lỗi AdminLTE + cách fix nhanh theo emoji style giống style bảng mà Tiến sĩ M hay dùng, nhìn cực trực quan.
✨ made by AI – Debugging Wizard Edition 🛠️
Nhận xét
Đăng nhận xét