bwstudio
b0865ea18d
根因：此前为移动端手写的一段折叠逻辑直接给 body 加 pear-mini，
绕过了 admin.js 里唯一的同步入口 collapse()，导致三处状态错位——
布局层认为已折叠（侧栏宽 0、菜单文字被 CSS 隐藏），
菜单 DOM 仍是展开态（#side 没有 pear-nav-mini），于是"文字看不见、
但子菜单又在原地铺开"。
处理：
- templates/system/index.html 还原为框架原始版本，删除手写的
foldSidebar() IIFE 与首屏强制加类逻辑
- 删除无引用的死文件 templates/system/common/{head,side}.html
- 新增插件 plugins/mobileUI，以运行时注入 mobile.js 的方式实现移动端增强：
* 首屏折叠只通过框架的 li.collapse 点击完成，不手写 class
* 轮询等待菜单异步渲染就绪后再折叠
* 补齐 framework 内部状态 isCollapse（后端 /rights/configs 把键拼成了
"collaspe"，admin.js 读 collapse 恒为 undefined，窄屏 resize 会反向展开）
* 触屏下点击菜单外区域收起 mini 浮层（触屏没有可靠的 mouseleave）
* 展开态点击叶子菜单后自动收起侧栏
- applications/config.py 的 PLUGIN_ENABLE_FOLDERS 追加 cookieManager、mobileUI
framework 业务逻辑零改动，仅 config.py 一行配置。
2.5 KiB
2.5 KiB
mobileUI —— 移动端侧栏增强插件
修复手机/窄屏（≤768px）下后台左侧菜单的两个问题：
- 菜单错位：侧栏只剩一列图标、文字全部消失；
- 子菜单不自动隐藏：mini 模式下点开的子菜单浮层赖着不走。
为什么会出问题
Pear Admin 的"侧栏折叠"由三处状态共同决定：
| 状态 | 作用 |
|---|---|
body/.pear-admin 上的 pear-mini |
整页布局：.layui-side 压成 0/60px |
#side 上的 pear-nav-mini |
菜单自身宽度、子菜单内联展开还是悬浮弹出 |
PearAdmin.instances.menu.isCollapse |
框架状态机，决定下一次 collapse 的方向 |
框架把三者的同步封装在 admin.js 的私有函数 collapse() 里，只能通过
点击 .collapse / .pear-cover 触发。此前在 templates/system/index.html
里手写的"首屏 addClass('pear-mini')"绕过了它，导致 body 与 #side 状态反相：
布局按折叠渲染（文字被 .pear-mini ... span {display:none} 藏掉、侧栏 0px），
菜单却停留在展开态 —— 即"只剩图标""子菜单收不起来"。
本插件的做法（不改 framework 任何文件）
event_finish注册after_request，仅向后台主框架页（含#side的 HTML） 注入static/mobile.js；- 折叠一律触发框架原生入口（
li.collapse的点击），三态由框架同步； - 折叠后补写
menu.isCollapse = true：后端/rights/configs里菜单配置的键 拼成了collaspe（框架读collapse），done 回调会把它覆写成undefined， 不补写的话窄屏下任何 resize 都会把侧栏反向弹开； - 触屏补位：mini 浮层靠
mouseenter/mouseleave开关，而触屏 tap 后mouseleave常常不来 —— 点菜单以外区域时主动收起浮层； - 移动端习惯：展开态点叶子菜单后自动收起侧栏。
涉及文件
plugins/mobileUI/
├── __init__.json # 插件元信息
├── __init__.py # after_request 注入 + 静态蓝图
├── static/mobile.js # 全部前端逻辑
└── README.md
启用
applications/config.py → PLUGIN_ENABLE_FOLDERS 加入 "mobileUI"，重启即可。
备注
配置里 "collaspe" 的拼写错误属于框架原文件（applications/view/system/rights.py），
按"不改动原项目内容"的原则未修正；插件已在运行时补齐状态，不受影响。
若未来升级框架，可顺手把键名改为 "collapse"。