Django Jazzmin 侧边栏模型默认折叠配置指南

Django Jazzmin 是一个优秀的 Django 后台管理界面美化插件，它提供了丰富的自定义选项。在实际项目开发中，管理员经常需要调整侧边导航栏的显示方式以优化用户体验。本文将详细介绍如何配置 Jazzmin 使应用模型在侧边菜单中默认折叠显示。

核心配置参数

Jazzmin 通过 JAZZMIN_SETTINGS 字典中的 navigation_expanded 参数控制侧边栏的默认展开状态。这个布尔值参数决定了应用模型在初始加载时的显示方式：

• 当设置为 True（默认值）时，所有应用模型会默认展开显示
• 当设置为 False 时，所有应用模型会默认折叠显示

具体实现方法

在 Django 项目的 settings.py 文件中，找到或添加 JAZZMIN_SETTINGS 配置项，设置 navigation_expanded 参数：

JAZZMIN_SETTINGS = {
    # 其他配置项...
    "navigation_expanded": False,  # 使侧边栏模型默认折叠
    # 其他配置项...
}

效果对比

配置前后会有明显的视觉差异：

1. 默认展开状态（navigation_expanded=True）

   • 所有应用模型直接显示
   • 适合模型数量较少的情况
   • 管理员可以直接看到所有可用功能

2. 默认折叠状态（navigation_expanded=False）

   • 应用模型初始显示为折叠
   • 需要点击应用名称才能展开查看具体模型
   • 适合模型数量较多的大型项目
   • 保持界面整洁，减少视觉干扰

最佳实践建议

1. 对于小型项目（模型数量少于10个），建议保持默认展开状态
2. 对于中型到大型项目，推荐使用折叠模式提升导航效率
3. 可以结合 hide_apps 和 hide_models 参数进一步优化导航结构
4. 考虑用户习惯，如果大多数用户只需要访问少数几个模型，折叠模式更合适

注意事项

1. 修改配置后需要重启 Django 开发服务器才能生效
2. 该设置会影响所有用户的界面显示
3. 折叠状态不会影响实际功能访问权限
4. 用户的手动展开/折叠操作会被浏览器记住（基于 localStorage）

通过合理配置 navigation_expanded 参数，开发者可以显著提升后台管理界面的使用体验，特别是在模型数量较多的复杂项目中。这种细粒度的界面控制正是 Django Jazzmin 的优势之一。