Function scrollElementToTop

web/components/HashScroller.tsx:125–136

* 把 el 滚到其滚动容器的顶部。 * * 不用 el.scrollIntoView：在多层 overflow 嵌套（如 PageColumns 的 main）下， * 浏览器对"该让谁滚"判断不稳；显式找最近 scroll ancestor 自己算 offset 最可控。

(el: HTMLElement, topOffset = 12)

 * 浏览器对"该让谁滚"判断不稳；显式找最近 scroll ancestor 自己算 offset 最可控。
 */
function scrollElementToTop(el: HTMLElement, topOffset = 12) {
  const scrollable = findScrollableAncestor(el);
  if (scrollable instanceof Window) {
    const top = el.getBoundingClientRect().top + window.scrollY - topOffset;
    window.scrollTo({ top, behavior: "smooth" });
  } else {
    const elRect = el.getBoundingClientRect();
    const containerRect = scrollable.getBoundingClientRect();
    const top = elRect.top - containerRect.top + scrollable.scrollTop - topOffset;
    scrollable.scrollTo({ top, behavior: "smooth" });
  }
}

/**
 * 等待 main 容器的 scrollHeight 稳定（连续 N 帧不变），表示 React 渲染 + layout 完成；