AdminLTE_CN 发行版

4.0.0-rc7

2026-04-28 11:33

## 主要亮点

此版本对布局和推拉菜单插件进行了重大的 JavaScript 重构，修复了影响打印、分页、模态框和动画的几个错误，并将所有依赖项更新到了最新的语义化版本兼容版本。

## 错误修复

- **打印布局**：侧边栏和主要内容区域现在在浏览器打印预览中均可见（#5982，PR #5996 由 @herley-shaori 贡献）
- **分页圆角边框**：同步了 `_bootstrap-variables.scss` 中 calc 语法与 Bootstrap 5.3 的一致，修复了分组分页按钮显示全圆角边框的问题（#5951，由 @Kneemund 报告）
- **ESC 键与模态框**：`handleEscapeKey()` 方法不再绕过 Bootstrap 5 中模态框的 `keyboard: false` 选项（#5993，由 @braytac 报告）
- **slideDown/slideUp 动画**：修复了持续时间为 0 时 `setTimeout` 排序不可靠的问题，该问题曾导致侧边栏树形菜单的即时打开功能失效（#5964，PR 由 @Kneemund 贡献）
- **CSS 代码检查**：修复了打印布局规则中的属性顺序问题（#5997，由 @lfiorini 报告）

## 重构

- **布局过渡效果处理**（#5956 由 @dfsmania 贡献）：
  - 修复了有缺陷的 `holdTransition` 定时器（局部变量提升为实例属性）
  - 移除了每次调用时重复注册的 `resize` 事件监听器
  - 将布局初始化整合到 `layout.ts` 中（移除 `adminlte.ts` 中的重复代码）
  - 将 `app-loaded` 类的应用移到了布局 Data API 部分

- **推拉菜单插件全面重构**（#5954 由 @dfsmania 贡献）：
  - 使用单个 `PushMenu` 实例，而非为每个事件处理程序创建新实例
  - 正确分离了 `setupSidebarBreakPoint()` 和 `updateStateByResponsiveLogic()` 方法
  - `sidebar-open` 类仅在移动端视口下添加（与 v3 版本的行为一致）
  - 配置现可从侧边栏元素的数据属性中读取
  - 移除了未使用的 `menusClose()` 方法和废弃常量

## 改进

- **登录/注册框宽度**：从 360px 增加到 400px，以获得更好的表单可读性（#5963 由 @dfsmania 贡献）
- **TypeScript 编译**：在 `tsconfig.json` 中添加了 `removeComments: true`，未压缩版的 `adminlte.js` 体积减少了约 15%（#5953 由 @dfsmania 贡献）

## 依赖项更新

所有依赖包均已更新至最新的语义化版本兼容版本：
- `@astrojs/check` 0.9.7，`@astrojs/mdx` 4.3.13
- `@typescript-eslint/*` 8.57.0
- `astro` 5.18.0，`autoprefixer` 10.4.27
- `eslint` 9.39.4，`eslint-plugin-astro` 1.6.0
- `fs-extra` 11.3.4，`nodemon` 3.1.14
- `postcss` 8.5.8，`prettier` 3.8.1
- `rimraf` 6.1.3，`rollup` 4.59.0
- `sass` 1.97.3，`terser` 5.46.0

## 破坏性变更

- **侧边栏状态持久化现为可选功能**：`enablePersistence` 的默认值改为 `false`（此前为 `true`）。如需恢复在页面加载间记忆侧边栏状态的原有行为，请在侧边栏元素上添加 `data-enable-persistence="true"` 属性：

```html
  <aside class="app-sidebar" data-enable-persistence="true"></aside>
  ```

## 贡献者

感谢所有为此版本做出贡献的朋友：
- @dfsmania（Diego Smania）—— 布局重构、推拉菜单重构、登录框宽度调整、tsconfig 清理
- @herley-shaori（Herley）—— 打印布局修复
- @Kneemund（Moritz Mechelk）—— 分页 bug 报告、slideDown/slideUp 修复
- @braytac —— ESC 键模态框 bug 报告
- @lfiorini —— CSS 代码检查问题报告

最后提交信息为：字典更新

4.0.0-rc4

aede9b7

2025-07-22 18:25

AdminLTE_CN 4.0.0 rc4

最后提交信息为： AdminLTE-4.0.0-rc4

4.0.0-beta3

391faaa

2025-04-09 10:28

AdminLTE_CN 4.0.0 beta3

最后提交信息为：增加官方 GitHub 地址

4.0.0-beta2

e35cc67

2024-09-12 16:21

AdminLTE_CN 4.0.0 beta2

最后提交信息为：移除广告、统计

3.2

fcdca56

2023-04-13 15:38

AdminLTE_CN 3.2

**破坏性修改**
我们放弃了官方的 node 12，不再支持任何 node 12 问题/错误，它可能还在工作。

**主要功能：**
* 增强暗色模式
* SVG 字体 Awesome 图标支持
* Docker 开发预设
* 重构 深/亮 颜色
* 自定义滚动条样式（非插件滚动条）

**修复：**
* IFrame 插件中的各种修复
* 修复侧边拦搜索插件中的链接编码
* 修正了 sass 构建时的分区警告
* 修复默认和轮廓按钮的禁用状态
* 修复打印时没有可见的背景色
* 各种深色模式修复

**变更：**

* 为 CardRefresh 插件添加加载错误回退
* 为 ControlSidebar 插件和 PushMenu 插件添加折叠完成事件
* 将动画速度添加到 ControlSidebar 插件和 PushMenu 插件
* 为 ControlSidebar 插件添加目标选择
* 为 ExpandableTable 插件添加元素后备
* 将 allowReload 和 autoDarkMode 添加到 IFrame 插件
* 添加 iframe-dark 示例

感谢他们出色的贡献[@liljack](https://github.com/liljack)、[@danny007in](https://github.com/danny007in)、[@curiousteam](https://github.com/curiousteam)、[@equada](https://github.com/equada)、[@Shidersz](https://github.com/Shidersz)、[@gurvirlochab](https://github.com/gurvirlochab)、[@ZhangChengLin](https://github.com/ZhangChengLin)、[@mostafahesham-dev](https://github.com/mostafahesham-dev)、[@smtbos](https://github.com/smtbos)、[@leonardxfce](https://github.com/leonardxfce)、[@anilloutombam](https://github.com/anilloutombam)、[@13324](https://github.com/13324)、[@SmileYzn](https://github.com/SmileYzn)、[@hkvstore](https://github.com/hkvstore)、[@rikuson](https://github.com/rikuson)、[@kreic51](https://github.com/kreic51)、[@forxer](https://github.com/forxer) 和 [@mahmoudalsaman](https://github.com/mahmoudalsaman)。

要查看完整的更新日志，请[点击这里](https://github.com/ColorlibHQ/AdminLTE/compare/v3.1.0...v3.2.0)。

**本地化更新：**
datatables 本地化字典更新 via glacier0315

最后提交信息为： datatables 本地化字典更新

3.1

65a0d63

2021-06-01 01:47

AdminLTE_CN 3.1

v3.1 新功能：

- 暗色模式
- 新组件
  - 月份分页
  - 登录/注册 v2
  - IFrame 模式
  - uPlot 图表
  - 看板
  - 页面
      - FAQ
      - 联系我们
  - 搜索
      - 简单
      - 高级
  - 简单的看板
  - 简单的预加载器

- 新的演示示例
    - 步进器/向导
    - 多文件上传
    - Codemirror
    - 带按钮的数据表
    - 表单输入样式
- 新的侧边栏功能
    - 侧边栏搜索
    - 自定义区域
- 新的 JS 插件 & JS 插件功能
    - 全屏模式
    - 侧边栏搜索插件
    - ExpandableTables 插件
    - IFrame 插件
    - 导航栏搜索插件
- 还有
    - 添加浅色 FontAwesome, 双色 & svg 支持
    - 添加数据表滚动插件
    - 添加 btn-app 颜色变化
    - 使用品牌内的 pushmenu 增强品牌链接
    - 添加输入框仅底部边框样式
    - 添加 custom-control-input 颜色变化
    - 为复选 & 单选框增加 custom-control-input-outline
    - 用于多个控制侧边栏的增强型 ControlSidebar 插件

变化：

- replaced small-box font-size transition with transform
- 修复 layout-boxed 侧边栏与 sidebar-mini
- 文档中添加 ASP.NET Boilerplate & CakePHP 4.x 实现
- 压缩图像 (jpg & png)
- 添加 StyleLint, ESLint & BundleWatch
- 增强各种 npm 脚本命令
- 更新 bootstrap 到 4.6.0
- 移除 glyphicon 无用的
- 更新各种 HTML 标记
    - 指定 lang 属性
    - 至 2021 年
    - 替换 http:// 为 https://
    - 移除 rel 属性以保持一致性
    - 为外部链接添加 rel=noopener
    - 为 Google 字体指定 diplay=fallback
- 添加侧边栏搜索插件
- 添加月份分页组件
- 添加可扩展的表格插件
- 添加侧边栏自定义区域组件
- 使用品牌内的 pushmenu 增强品牌链接
- 添加浅色 FontAwesome, 双色 & svg 图标支持
- 修复 maximized-card card-body 溢出
- 添加 bs-stepper 插件和演示
- 添加 codemirror 插件和演示
- 添加 dropzonejs 插件和演示
- 添加迷你图演示
- 移除 flot-old
- 移除不需要的 jquery-ui
- 添加登录、注册和恢复密码 v2 页面
- 添加数据表按钮示例
- 添加联系我们和常见问题演示
- 添加 iframe 插件
- 在表单/常规中添加了三个新样式示例
- 添加 custom-control-input 颜色变化
- 为复选 & 单选框增加 custom-control-input-outline
- 添加暗色模式
- 添加简单的看板
- 添加卡片图像叠加示例
- 添加数据表搜索窗格插件
- 添加上传图表插件和演示
- 移除开发依赖
    - @babel/cli
    - @babel/plugin-external-helpers
    - css-loader
    - path
    - set-value
    - style-loader
- 移除依赖
    - @fullcalendar/bootstrap (替换为新的依赖 fullcalendar)
    - @fullcalendar/core (替换为新的依赖 fullcalendar)
    - @fullcalendar/daygrid (替换为新的依赖 fullcalendar)
    - @fullcalendar/interaction (替换为新的依赖 fullcalendar)
    - @fullcalendar/timegrid (替换为新的依赖 fullcalendar)
- 以及其他一些小的修复/更改

感谢 **@XhmikosR** 提供 55 多个令人难以置信的功能也感谢 **@shawnheide, @mineminemine, @shailesh-ladumor, @SmileYzn, @yangfuhai, @nisarhassan12, @danny007in**

更完整的变更日志，请[查看此处][1]。

[1]: https://github.com/ColorlibHQ/AdminLTE/compare/v3.0.5...v3.1.0

最后提交信息为： update README.md.