Home Assistant 前端侧边栏排序问题分析与解决方案

问题现象

近期在Home Assistant前端界面中，使用Firefox 137及以上版本的用户普遍反映无法通过拖拽方式重新排列侧边栏菜单项。具体表现为：

• 长按"Home Assistant"标题可进入编辑模式（图标出现抖动效果）
• 但尝试拖拽菜单项时无法改变其位置
• 该问题在Windows 11和Ubuntu系统上的Firefox 137.x版本中均存在
• Chrome/Edge等其他浏览器工作正常

技术背景

Home Assistant的侧边栏排序功能依赖于浏览器的拖放API实现。正常情况下：

1. 用户长按触发编辑模式
2. 系统启用HTML5的Drag and Drop接口
3. 通过JavaScript事件处理拖拽逻辑
4. 最终排序结果保存在浏览器的本地存储中

问题根源

经过社区分析，此问题与Firefox 137版本引入的某些改动有关：

• 可能是浏览器对HTML5拖放API的实现变更
• 也可能是与Home Assistant前端使用的排序库存在兼容性问题
• 特别值得注意的是，Firefox 133及以下版本不受影响

临时解决方案

目前可通过以下方式手动调整侧边栏顺序：

方法一：通过浏览器开发者工具修改

1. 打开浏览器开发者工具（F12）
2. 切换到"存储(Storage)"标签页
3. 找到"Local Storage"中的sidebarPanelOrder项
4. 修改其值为JSON格式的菜单项数组，例如：

["dashboard-weather","dashboard-system","developer-tools"]

5. 刷新页面生效

方法二：跨浏览器复制配置

1. 在其他正常浏览器中调整好侧边栏顺序
2. 从该浏览器的本地存储中复制sidebarPanelOrder值
3. 粘贴到Firefox的对应存储位置

注意事项

1. 菜单项名称需使用其URL标识形式，如"dashboard-weather"对应天气面板
2. 可通过临时移除菜单项来查看其准确标识名称
3. 修改后如默认面板显示异常，可检查浏览器书签是否指向特定URL

后续建议

对于普通用户：

• 可暂时使用其他浏览器管理侧边栏
• 或等待Home Assistant或Firefox的后续更新修复

对于开发者：

• 可考虑提交PR修复拖放兼容性问题
• 或为排序功能添加备选实现方案

此问题预计将在后续版本中得到官方修复，届时用户将可恢复正常拖拽排序体验。