CKAN项目中Facet Accordion的默认展开状态优化方案

在CKAN项目的最新UI改版中，设计团队提出了对Facet（分面导航）显示方式的改进需求。本文将详细介绍如何实现Facet Accordion的智能展开/折叠功能，以及背后的技术实现思路。

需求背景

在数据目录系统中，Facet（分面导航）是用户筛选数据的重要工具。设计团队希望将Facet呈现为可折叠的Accordion（手风琴式）组件，并遵循以下交互规则：

1. 当Facet内没有任何被选中的选项时，默认保持折叠状态
2. 当Facet内有一个或多个选项被选中时，默认展开显示

这种设计既能保持界面整洁，又能让用户快速看到当前应用的筛选条件。

技术实现方案

方案一：Jinja2模板过滤（初始方案）

最初的实现方案是在Jinja2模板中使用过滤器判断Facet中是否有活跃选项：

{% set active_items = items|selectattr('active')|list|length >= 1 %}

这种方法虽然能够实现功能，但存在几个问题：

1. 逻辑处理放在模板层不够优雅
2. 性能可能不是最优
3. 不利于代码的复用和维护

方案二：修改get_facet_items_dict方法（推荐方案）

更合理的做法是在Python层面修改get_facet_items_dict方法，使其返回Facet是否包含活跃选项的信息。这种方案具有以下优势：

1. 业务逻辑集中在后端处理
2. 减少模板中的复杂逻辑
3. 便于后续扩展和维护

实现思路是在返回Facet数据时，添加一个标识字段如has_active_items，然后在模板中根据这个字段决定Accordion的初始状态。

实现细节

在后端处理时，可以遍历Facet的所有选项，检查是否有active属性为True的项。如果有，则设置has_active_items为True。

模板层只需简单判断：

<div class="accordion" data-expanded="{{ has_active_items|default(false)|tojson }}">
  <!-- Facet内容 -->
</div>

扩展考虑

在实际应用中，还可以考虑以下扩展点：

1. 配置化：提供配置选项让管理员决定默认是全部展开还是根据活跃状态动态决定
2. 持久化：记住用户最后一次的展开/折叠状态
3. 动画效果：为展开/折叠添加平滑的动画过渡
4. 响应式设计：在不同屏幕尺寸下采用不同的默认策略

最佳实践建议

1. 优先在后端处理业务逻辑，保持模板简洁
2. 使用语义化的变量名如has_active_items提高代码可读性
3. 考虑添加单元测试确保功能稳定性
4. 文档化这个行为以便其他开发者理解

通过这种实现方式，既能满足设计需求，又能保证代码的质量和可维护性，为CKAN用户提供更友好的数据浏览体验。