Immich项目Web端搜索弹窗人物显示层级问题分析

在Immich项目的Web端界面中，当用户尝试通过搜索功能查看所有人物时，出现了一个界面显示层级的问题。具体表现为人物缩略图被其他搜索输入框遮挡，而不是按照预期显示为一个可滚动的面板。

问题现象

当用户打开搜索选项并点击"显示所有人物"时，界面渲染出现异常。所有的人物缩略图会被渲染在其他搜索输入框的下方，导致部分内容被遮挡。这种显示层级(z-index)的问题影响了用户体验，使得用户无法完整查看和选择所有可用的人物选项。

技术分析

这个问题属于典型的CSS层叠上下文(z-index)问题。在Web开发中，当多个元素需要重叠显示时，正确的z-index层级管理至关重要。从现象来看，人物缩略图面板的z-index值可能设置不当，或者其父元素的层叠上下文创建方式存在问题，导致其无法正确显示在其他输入框之上。

解决方案

项目维护团队已经确认了这个问题，并在v1.128.0版本中复现了该问题。针对此问题，团队已经提交了修复代码。修复方案可能包括：

1. 调整人物面板的z-index值，确保其高于其他输入元素
2. 检查并修正面板的定位(position)属性设置
3. 确保面板的父元素不会创建新的层叠上下文而影响子元素的显示层级

影响范围

该问题仅影响Web端界面，服务器和移动端应用不受影响。使用Arch Linux操作系统和Immich Server v1.128.0版本的用户可能会遇到此问题。

用户建议

对于遇到此问题的用户，建议：

1. 等待官方发布包含修复的版本更新
2. 临时解决方案可以是缩小浏览器窗口，减少其他输入框的显示区域
3. 避免同时打开多个搜索选项，减少界面元素的叠加

这个问题虽然不影响核心功能，但确实降低了搜索体验的便捷性。官方团队的快速响应和修复体现了项目对用户体验的重视。