Django Unfold项目中StackedInline无记录时的显示问题解析

在Django Unfold项目版本0.38.0中，开发者发现了一个关于StackedInline表单集的显示问题。这个问题主要出现在当内联表单集中没有任何记录时，界面缺少"添加记录"按钮的情况。

问题背景

StackedInline是Django Admin中一种常见的内联表单展示方式，它以垂直堆叠的形式显示关联模型的数据。在Django Unfold这个现代化管理界面主题中，开发者对原生Django Admin的模板进行了美化和功能增强。

问题现象

当使用StackedInline时，如果表单集中没有任何现有记录，界面本应显示"添加记录"按钮的位置却出现了空白。这个问题不会出现在TabularInline（表格形式的内联）中，因为TabularInline模板中已经包含了正确的条件判断。

技术分析

问题的根源在于模板文件stacked.html中的条件判断不完整。当前版本中，判断逻辑仅检查了表单集是否为空（inline_admin_formset.forms|length == 0），但没有同时检查用户是否有添加权限（inline_admin_formset.has_add_permission）。

正确的逻辑应该像tabular.html模板中那样，同时检查这两个条件：

{% if not inline_admin_formset.has_add_permission and inline_admin_formset.forms|length == 0 %}

解决方案

开发团队已经通过提交修复了这个问题。修复方案是在显示空状态时，同时检查两个条件：

1. 用户是否有添加记录的权限
2. 当前表单集是否为空

这样就能确保在以下情况下正确显示界面：

• 当有记录时：显示现有记录
• 当无记录但有添加权限时：显示"添加记录"按钮
• 当无记录且无添加权限时：显示空状态提示

最佳实践建议

对于使用Django Unfold的开发者，建议：

1. 及时更新到包含此修复的版本
2. 在自定义模板时，注意权限检查和空状态处理的完整性
3. 对于关键功能，应该同时编写前端和后端的权限验证

这个问题提醒我们，在开发管理界面时，权限控制和空状态处理都是需要特别注意的细节，它们直接影响用户体验和数据安全性。