本文详解如何为多个 .gy-section 元素分别绑定独立的悬停滑动动画，解决原代码中仅首个图片响应 hover 的问题，通过 querySelectorAll 遍历与事件委托优化，配合 CSS transform: translateY() 实现平滑、高性能的图片下滑效果。

本文详解如何为多个 `.gy-section` 元素分别绑定独立的悬停滑动动画，解决原代码中仅首个图片响应 hover 的问题，通过 `queryselectorall` 遍历与事件委托优化，配合 css `transform: translatey()` 实现平滑、高性能的图片下滑效果。

在实际开发中，当页面包含多个同类图片展示区块（如 .gy-section）时，若使用 querySelector(".gy-section") 获取元素，只会匹配第一个匹配项，导致后续区块无法响应悬停事件——这正是原始代码中“只有第一张图动”的根本原因。

要让每个区块独立响应交互，必须批量获取所有目标元素并为每个元素单独绑定事件监听器。推荐采用现代、可维护的方式，无需硬编码 ID，也无需修改 HTML 结构：

✅ 正确做法：使用 querySelectorAll + forEach

<div class="container">
  <div class="gallery">
    <div class="gy-section">
      <div class="gy-sec-img" style="background-image: url('photo1.jpg');"></div>
      <div class="gy-simg-title">风景一</div>
    </div>
    <div class="gy-section">
      <div class="gy-sec-img" style="background-image: url('photo2.jpg');"></div>
      <div class="gy-simg-title">风景二</div>
    </div>
    <div class="gy-section">
      <div class="gy-sec-img" style="background-image: url('photo3.jpg');"></div>
      <div class="gy-simg-title">风景三</div>
    </div>
  </div>
</div>

// 获取所有 gy-section 容器
const gySections = document.querySelectorAll('.gy-section');

gySections.forEach(section => {
  const imgEl = section.querySelector('.gy-sec-img');
  const titleEl = section.querySelector('.gy-simg-title');

  // 确保图片容器有明确高度（用于计算滑动距离）
  const containerHeight = section.offsetHeight;
  const imgHeight = imgEl.scrollHeight;

  // 悬停进入：向下平移，露出底部内容
  section.addEventListener('mouseenter', () => {
    const translateY = imgHeight - containerHeight;
    imgEl.style.transition = 'transform 0.4s ease-in-out';
    imgEl.style.transform = `translateY(-${translate}px)`;

    section.classList.add('gys-hover');
    imgEl.classList.add('gys-hover');
    if (titleEl) titleEl.classList.add('gst-hover');
  });

  // 悬停离开：复位
  section.addEventListener('mouseleave', () => {
    imgEl.style.transform = 'translateY(0)';

    section.classList.remove('gys-hover');
    imgEl.classList.remove('gys-hover');
    if (titleEl) titleEl.classList.remove('gst-hover');
  });
});

? 关键要点说明

• 避免 querySelector 单点匹配：它只返回首个元素；改用 querySelectorAll 获取 NodeList 后遍历处理。
• 推荐 transform 而非 backgroundPositionY：transform: translateY() 性能更优（GPU 加速），且逻辑更直观；backgroundPositionY 在背景图未设置 background-size: cover 或固定尺寸时易出现定位偏差。
• 动态计算滑动距离：imgEl.scrollHeight - section.offsetHeight 精确得出需位移的像素值，适配不同尺寸图片。
• CSS 配合建议（提升体验）：

  .gy-sec-img {
    height: 100%;
    background-size: cover;
    background-position: center top;
    overflow: hidden;
    transition: transform 0.4s ease-in-out;
  }
  .gy-section {
    overflow: hidden;
  }

⚠️ 注意事项

• 确保 .gy-sec-img 元素具有明确的 height 或 min-height，否则 scrollHeight 可能为 0；
• 若使用 background-image，请务必设置 background-size: cover 和 background-position，避免滑动后出现空白或错位；
• 不建议使用 setTimeout + await Promise 模拟动画时长——应依赖 CSS transition 或 Web Animations API 的 onfinish 回调，更精准可靠；
• 移除原代码中冗余的 animate() 调用和手动 style.backgroundPositionY 设置，既简化逻辑又提升兼容性。

通过以上重构，每个 .gy-section 都能独立、流畅地响应悬停，真正实现“所见即所得”的交互体验。