Primer CSS项目中details元素的查找匹配问题解析

在GitHub的Pull Request和Issue页面中，用户经常使用details元素来组织内容，通过点击可以展开或折叠详细信息。然而，近期发现当用户在Chrome浏览器中使用页面查找功能（Ctrl+F）时，如果匹配文本位于折叠的details元素内，这些元素不会自动展开显示匹配结果，这影响了用户体验。

问题背景

details元素是HTML5引入的一个交互式元素，允许创建可展开/折叠的内容区域。现代浏览器如Chrome 123+和即将发布的Safari版本都支持一个特性：当用户执行页面查找时，即使details元素处于折叠状态，浏览器也会临时"穿透"这些元素搜索内容，并在找到匹配时自动展开显示。

但在GitHub的PR/Issue页面中，这个功能却失效了。经过分析发现，这是由于Primer CSS项目中的样式规则导致的。项目中对未展开的details元素内容强制设置了display: none !important样式，这阻止了浏览器的默认查找穿透行为。

技术分析

浏览器实现查找匹配时，对于details元素有以下处理逻辑：

1. 当开始页面查找时，所有未展开的details元素会临时使其内容可访问
2. 这个过程不会修改元素的open属性
3. 查找完成后，元素状态恢复原状

然而，display: none的样式会完全从渲染树中移除元素，使得浏览器无法访问这些内容进行匹配检查。即使浏览器尝试临时"穿透"，由于CSS的强制隐藏，查找功能仍然无法发现这些内容。

解决方案

Primer CSS项目已经移除了相关样式规则。具体改动包括：

1. 删除对未展开details元素内容的display: none !important强制样式
2. 完全依赖浏览器对details元素的默认处理

这一改动具有以下优势：

• 恢复了浏览器原生的查找穿透功能
• 保持了details元素的基本交互行为
• 不会影响现有页面的视觉表现
• 为即将支持该特性的Safari浏览器做好准备

影响评估

这一改动是安全的，因为：

1. 所有现代浏览器都已原生支持details元素的展开/折叠行为
2. 不需要额外的CSS来模拟这一功能
3. 不会破坏现有页面的布局或功能
4. 实际上移除了可能干扰浏览器标准行为的代码

对于开发者来说，这意味着可以更自由地使用details元素组织内容，而不用担心影响用户的查找体验。对于最终用户，这将提供更符合预期的查找行为，特别是在处理包含大量折叠内容的PR和Issue时。

这一改进体现了Web标准逐渐成熟后，前端框架可以适当减少对浏览器原生功能的干预，转而更充分地利用平台能力，提供更自然用户体验的趋势。