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
mw.hook('wikipage.content').add(function($content) {
  if (window.innerWidth >= 768) { // Desktop only
    const idsToCollapse = [
      'Muling', 'Misc', 'Anti-ban', 'Anti-PK', 'Trip_Settings', 'Skills_Settings', 'Equipment'
    ];

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

      if (!heading) return;

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

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

// Helper: expand parent if needed
function expandParentSectionIfNeeded(heading) {
  if (!heading) return;

  const sectionHeading = heading.closest('.citizen-section-heading');
  if (sectionHeading) {
    const content = sectionHeading.nextElementSibling;
    if (content && content.classList.contains('citizen-section') && content.hidden) {
      content.hidden = false; // Expand hidden section
    }
  }
}

// === 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)); // 🔥 decode any special characters
      setTimeout(() => { // Slight delay to allow DOM ready
        const heading = document.getElementById(headingId);
        if (heading) {
          expandParentSectionIfNeeded(heading);

          setTimeout(() => {
            heading.scrollIntoView({ behavior: 'smooth', block: 'start' });
          }, 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) {
          expandParentSectionIfNeeded(heading);

          setTimeout(() => {
            heading.scrollIntoView({ behavior: 'smooth', block: 'start' });
          }, 50);
        }

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