Infinite scroll loop in docs / navtree

[NicoZweifel]

Summary

The site started infinitely scrolling, basically spazzing out when navigating. It originates from navtree.js, which is part of doxygen. It is a known issue and is apprently fixed in 1.11.0.

 const gotoAnchor = function(anchor,aname) {
    let pos, docContent = $('#doc-content');
    let ancParent = $(anchor.parent());
    if (ancParent.hasClass('memItemLeft') || ancParent.hasClass('memtitle')  ||
        ancParent.hasClass('fieldname')   || ancParent.hasClass('fieldtype') ||
        ancParent.is(':header')) {
      pos = ancParent.position().top;
    } else if (anchor.position()) {
      pos = anchor.position().top;
    }
    if (pos) {
      const dcOffset    = docContent.offset().top;
      const dcHeight    = docContent.height();
      const dcScrHeight = docContent[0].scrollHeight
      const dcScrTop    = docContent.scrollTop();
      let dist = Math.abs(Math.min(pos-dcOffset,dcScrHeight-dcHeight-dcScrTop));
      animationInProgress = true;
      docContent.animate({
        scrollTop: pos + dcScrTop - dcOffset
      },Math.max(50,Math.min(500,dist)),function() {
        window.location.href=aname;
        animationInProgress=false;
      });
    }
  }

To Reproduce
Steps to reproduce the behavior:

1. Go to https://www.flecs.dev/flecs/md_docs_2Systems.html#threading
2. Click on any nav link and scroll with the mouse wheel or click another one

See also here (music warning):

20260611-0951-23.1566316.mp4

Solution

Update doxygen.

I am not familiar with doxygen or what is needed to migrate and don't really have the time to get into it now but thought I'd leave this here anyway.

[SanderMertens]

This is not a doxygen issue, but a problem with the doxygen-awesome template. This has been a longtime issue that persisted across updates, but I'll see if there's a fix for it.

[NicoZweifel]

This is not a doxygen issue, but a problem with the doxygen-awesome template. This has been a longtime issue that persisted across updates, but I'll see if there's a fix for it.

Are you sure? It seems to be fixed 1 minor version later according to the issue and linked commit and as far as I remember I traced it back and fixed it manually in the browser too by editing navtree.js, which is part of doxygen.

The commit adds this:

    if (!animationInProgress) {

the doxygen-awesome template also has an issue that points towards this being fixed in upstream by the exact version one minor version above what the flecs docs are using (1.10.0 - 1.11.0).

Ofc you can try to patch it by yourself or try to find another way if you want. Good luck!