adminlte

AdminLTE 是一款由 AdminLTE.io 分发的 MIT 许可开源管理仪表盘 UI 模板。本仓库为 HTML/Bootstrap 核心版本，相同的设计在其他技术栈的独立仓库中同步维护。 技术与布局 - 基于 Bootstrap 5.3 和原生 JavaScript 构建，v4 版本不再依赖 jQuery。 - 响应式布局，适配从小型移动端屏幕到大型桌面端的各种设备。 - 深色模式采用 Bootstrap 5.3 原生的 data-bs-theme 属性，而非自定义 body 类。 - 支持 RTL（从右至左）布局，并提供可选的颜色样式表：dist/css/adminlte-colors.css（重新设计的颜色，包含 17 个皮肤预设和用于品牌化的 data-lte-primary 钩子）或 dist/css/adminlte-colors-v3.css（保留 AdminLTE 3 的 18 种颜色）。adminlte.css 中未添加额外内容。 安装与开发 - CDN：通过 jsDelivr 链接 admin-lte@4 的 CSS 和 JS，无需构建步骤。 - npm：执行 npm install admin-lte@4。 - Composer：执行 composer require almasaeed2010/adminlte。 - AdminLTE 自身开发：执行 npm install，然后通过 npm start 在 3000 端口启动带实时刷新的开发服务器；npm run build 用于开发资源；npm run production 用于完整的 lint、优化和 bundlewatch 流水线。此外还提供了 npm run css、npm run js 和 npm run lint 等独立任务。 v4 版本变更 README 将 v4 系列描述为基于 Bootstrap 5.3 且不含 jQuery 的彻底重写。它新增了 18 个演示页面并重构了文档。演示页面涵盖：应用（结合 FullCalendar 的日历、结合 SortableJS 的看板、聊天、文件管理器、项目、邮箱收件箱/阅读/撰写）、表单（带验证的四步向导）、表格（基于 Tabulator 的无 jQuery 数据表）、页面（个人资料、设置、发票、定价、FAQ）以及错误页面（404, 500, 维护）。 4.3 版本发行说明提到：SidebarSearch 插件（支持输入过滤侧边栏菜单、自动展开匹配项并在清除时恢复菜单）；三种尺寸的丝带角标（支持 RTL 镜像）；社交与帖子组件（.user-block, .post, .widget-user, .widget-user-2, .description-block）；以及三个新演示页面（图库、搜索结果、丝带）。通用 UI 展示中增加了导航标签页、模态框和侧边栏（offcanvas），文档中增加了卡片、杂项和语言切换页面，确保每个提供 CSS 的组件都有参考页。 从 v3 迁移 README 列出了破坏性变更：类名重命名（如 .wrapper 变为 .app-wrapper, .main-header 变为 .app-header, .main-sidebar 变为 .app-sidebar, .content-wrapper 变为 .app-main）；数据属性变更（如 data-toggle 变为 data-bs-toggle, data-widget="pushmenu" 变为 data-lte-toggle="sidebar" 以及 treeview 的相应变更）；深色模式迁移至 data-bs-theme。移除了内置的 plugins/ 文件夹，并提供了一张映射表，将 v3 的 jQuery 组件映射到原生 JS 替代方案（例如 Select2 对应 Tom Select，DataTables 对应 Tabulator，Summernote 对应 Quill）。 框架版本 独立仓库将相同的仪表盘集成至 React 和 Next.js、Vue 3 和 Nuxt、Laravel（Blade 组件、配置驱动菜单、认证脚手架）、Django（可复用应用、菜单过滤流水线、主题化管理后台）、Symfony（Twig 组件、AssetMapper、EasyAdmin 主题）、Angular、ASP.NET Core（Blazor 组件及 MVC/Razor Pages 标签助手）和 Drupal。每个版本通过各自的包管理器入口安装。 部署与安全 AdminLTE 是一个 UI 模板：生产环境部署应仅包含编译后的 dist 资源和应用程序文件，绝不能包含 node_modules、演示 HTML 页面或 src/ 目录。README 指出 CVE-2021-36471 存在争议，该漏洞是指在错误部署示例文件时演示页面可被访问；SECURITY.md 提供了关于身份验证和最佳实践的详细指南。 浏览器支持、贡献与许可 Bootstrap 5.3 支持当前版本的 Chrome, Firefox, Safari 和 Edge，构建脚本支持 Windows, macOS 和 Linux 跨平台运行。贡献者需针对 master 分支：安装 Node.js LTS，运行 npm install 和 npm start，在提交前进行 lint，然后发起 pull request。本项目采用 MIT 许可，README 同时提供了高级模板、GitHub Sponsors 或 PayPal 捐赠选项以支持免费版本。