💡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 pluginsdist.


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.cssdatatables.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

Bài đăng phổ biến từ blog này

🌈 Tự Động Highlight Code Trong Blogger

🧭CRUD CHUẨN LARAVEL

🚀01 giờ học cách sử dụng Developer Console