MediaWiki:Citizen.js

Note: After publishing, you may have to bypass your browser's cache to see the changes.

• Firefox / Safari: Hold Shift while clicking Reload, or press either Ctrl-F5 or Ctrl-R (⌘-R on a Mac)
• Google Chrome: Press Ctrl-Shift-R (⌘-Shift-R on a Mac)
• Edge: Hold Ctrl while clicking Refresh, or press Ctrl-F5.

/* All JavaScript here will be loaded for users of the Citizen skin */

// Collapse specific headers by default on Desktop
mw.hook('wikipage.content').add(function($content) {
  if (window.innerWidth >= 768) {
    const idsToCollapse = [
      'Muling', 'Misc', 'Anti-ban', 'Anti-PK', 'Trip_Settings', 'Skills_Settings', 'Equipment'
    ];

    idsToCollapse.forEach(function(rawId) {
      const id = rawId.replace(/ /g, "_");
      const heading = document.getElementById(id);

      if (!heading) return;

      const sectionHeading = heading.closest('.citizen-section-heading');
      const content = sectionHeading?.nextElementSibling;

      if (content && content.classList.contains('citizen-section')) {
        content.hidden = 'until-found'; // collapse by default
      }
    });
  }
});

// Helper: Expand any collapsed parent citizen-section containing the heading
function expandCitizenSectionFromHeading(heading) {
  if (!heading) return;

  let current = heading;

  while (current) {
    // Expand if we find a collapsed citizen-section
    if (current.classList && current.classList.contains('citizen-section') && current.hidden) {
      current.hidden = false;
    }

    // Stop walking if we hit a section heading
    if (current.classList && current.classList.contains('citizen-section-heading')) {
      break;
    }

    current = current.parentElement;
  }
}

// Helper: Smooth scroll to heading with smart upward offset
function smoothScrollToHeading(heading) {
  if (!heading) return;

  heading.scrollIntoView({ behavior: 'smooth', block: 'start' });

  setTimeout(() => {
    const offset = 60; // How much we want to adjust upward
    const maxScrollableUp = window.scrollY; // How much room we have to scroll upward

    if (maxScrollableUp > offset) {
      window.scrollBy(0, -offset); // Only scroll up if possible
    } else {
      window.scrollTo({ top: 0, behavior: 'smooth' }); // Scroll to top if near the top
    }
  }, 300); // Wait for smooth scroll to finish
}


// === Handle direct URL loads with a hash (on page load) ===
mw.hook('wikipage.content').add(function() {
  if (window.innerWidth >= 768) {
    const hash = window.location.hash;
    if (hash && hash.length > 1) {
      const headingId = decodeURIComponent(hash.substring(1));
      setTimeout(() => {
        const heading = document.getElementById(headingId);
        if (heading) {
          expandCitizenSectionFromHeading(heading);

          setTimeout(() => {
            smoothScrollToHeading(heading);
          }, 50);
        }
      }, 100);
    }
  }
});

// === Hook into Citizen TOC (Contents Menu) clicks ===
mw.hook('wikipage.content').add(function() {
  if (window.innerWidth >= 768) {
    mw.loader.using('skins.citizen.toc').then(function() {
      const citizenToc = require('skins.citizen.toc');
      const originalOnHeadingClick = citizenToc.props.onHeadingClick;

      citizenToc.props.onHeadingClick = function(id) {
        const headingId = id.replace(/^toc-/, '');
        const heading = document.getElementById(headingId);
        if (heading) {
          expandCitizenSectionFromHeading(heading);

          setTimeout(() => {
            smoothScrollToHeading(heading);
          }, 50);
        }

        if (originalOnHeadingClick) {
          originalOnHeadingClick(id);
        }
      };
    });
  }
});

// === Safely intercept TOC clicks directly to fix expand timing ===
mw.hook('wikipage.content').add(function() {
  if (window.innerWidth >= 768) {
    setTimeout(() => {
      document.querySelectorAll('#mw-panel-toc a[href^="#"]').forEach(function(anchor) {
        anchor.addEventListener('click', function(e) {
          const hash = decodeURIComponent(this.getAttribute('href')).substring(1);
          const heading = document.getElementById(hash);

          if (heading) {
            e.preventDefault(); // Prevent native jump
            expandCitizenSectionFromHeading(heading);

            setTimeout(() => {
              smoothScrollToHeading(heading);
            }, 50);
          }
        });
      });
    }, 200);
  }
});