MediaWiki:Mobile.js
Appearance
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 mobile site */
/* Note, there is no corresponding User:Username/mobile.js; however users may use User:Username/minerva.js */
function addPortletLink() {
mw.log.warn('addPortletLink is deprecated on desktop and never implemented on mobile', 'More information on https://www.mediawiki.org/wiki/ResourceLoader/Migration_guide_(users)#addPortletLink');
}
// CapSach — Mobile TOC overlay (all skins; phone widths)
(function () {
// Don’t run on very wide screens (tablet/desktop have native TOC)
if (window.matchMedia('(min-width: 768px)').matches) return;
// Only on normal content pages
if (window.mw && mw.config && mw.config.get) {
var isArticle = !!mw.config.get('wgIsArticle');
if (!isArticle) return;
}
// Find the content root; MobileFrontend restructures DOM, so be flexible
var root =
document.querySelector('#mw-content-text .mw-parser-output') ||
document.querySelector('.mw-parser-output') ||
document.getElementById('mw-content-text') ||
document.querySelector('#content') ||
document.body;
// Collect headings (H2–H6). Prefer spans with .mw-headline (stable anchor ids)
var items = [];
var headings = root.querySelectorAll('h2, h3, h4, h5, h6');
headings.forEach(function (h) {
var level = parseInt(h.tagName.slice(1), 10);
if (level < 2 || level > 6) return;
var headline = h.querySelector('.mw-headline') || h;
var id = headline.id || h.id;
var text = (headline.textContent || h.textContent || '').trim();
if (!id || !text) return;
items.push({ id: id, text: text, level: level });
});
// Show only if there are enough headings to be useful (match core default)
if (items.length < 3) return;
// Create trigger button (bottom-left; avoids “Back to top” on bottom-right)
var btn = document.createElement('button');
btn.id = 'cps-open-toc';
btn.type = 'button';
btn.setAttribute('aria-label', 'Open table of contents');
btn.innerHTML = '<span class="icon" aria-hidden="true">≡</span><span class="label">TOC</span>';
document.body.appendChild(btn);
// Overlay + panel
var overlay = document.createElement('div');
overlay.id = 'cps-toc-overlay';
overlay.setAttribute('aria-hidden', 'true');
var panel = document.createElement('div');
panel.id = 'cps-toc-panel';
panel.setAttribute('role', 'dialog');
panel.setAttribute('aria-modal', 'true');
panel.setAttribute('aria-label', 'Table of contents');
var header = document.createElement('div');
header.id = 'cps-toc-header';
header.innerHTML =
'<h2 id="cps-toc-title">Contents</h2>' +
'<button id="cps-toc-close" type="button" aria-label="Close">×</button>';
var list = document.createElement('ul');
list.id = 'cps-toc-list';
items.forEach(function (it) {
var li = document.createElement('li');
li.setAttribute('data-level', String(it.level));
var a = document.createElement('a');
a.href = '#' + it.id;
a.textContent = it.text;
li.appendChild(a);
list.appendChild(li);
});
panel.appendChild(header);
panel.appendChild(list);
overlay.appendChild(panel);
document.body.appendChild(overlay);
// Focus handling
var lastFocus = null;
function openOverlay() {
lastFocus = document.activeElement;
overlay.classList.add('is-open');
overlay.setAttribute('aria-hidden', 'false');
document.body.style.overflow = 'hidden';
// Focus first link for accessibility
var firstLink = list.querySelector('a');
if (firstLink) firstLink.focus({ preventScroll: true });
}
function closeOverlay() {
overlay.classList.remove('is-open');
overlay.setAttribute('aria-hidden', 'true');
document.body.style.overflow = '';
if (lastFocus && lastFocus.focus) lastFocus.focus({ preventScroll: true });
}
btn.style.display = 'flex'; // reveal trigger now that we know we have headings
btn.addEventListener('click', openOverlay);
overlay.addEventListener('click', function (e) {
// Click outside the bottom sheet closes
if (e.target === overlay) closeOverlay();
});
overlay.querySelector('#cps-toc-close').addEventListener('click', closeOverlay);
overlay.addEventListener('keydown', function (e) {
if (e.key === 'Escape') closeOverlay();
});
// Navigate and try to ensure mobile-collapsed sections are visible
list.addEventListener('click', function (e) {
var a = e.target.closest('a');
if (!a) return;
e.preventDefault();
var targetId = a.getAttribute('href').slice(1);
var target = document.getElementById(targetId);
closeOverlay();
if (target) {
try {
target.scrollIntoView({ behavior: 'smooth', block: 'start' });
} catch (_) {
target.scrollIntoView(true);
}
// Update URL hash after a tick (so browser back works)
setTimeout(function () {
if (history && history.replaceState) {
history.replaceState(null, '', '#' + targetId);
} else {
location.hash = targetId;
}
}, 200);
// MobileFrontend: headings may be inside collapsed sections.
// Heuristic: click the nearest toggle if present.
var maybeToggle = target.closest('.collapsible-block, .mf-section') ||
target.closest('section');
if (maybeToggle && maybeToggle.classList.contains('collapsed')) {
// Try to open; fallback by clicking the first heading inside
var headingToggle = maybeToggle.querySelector('.section-heading, h2, h3, h4, h5, h6');
if (headingToggle) headingToggle.click();
}
}
});
// Re-hide on rotation/resize to tablet/desktop
window.addEventListener('resize', function () {
if (window.matchMedia('(min-width: 768px)').matches) {
btn.style.display = 'none';
closeOverlay();
} else {
btn.style.display = 'flex';
}
}, { passive: true });
})();
// CapSach — force sections expanded on the MobileFrontend site (all mobile skins)
(function () {
// Only run on the MobileFrontend mobile site (works for Minerva, Vector, etc.)
var body = document.body;
if (!body || !body.classList.contains('mw-mf')) return; // detect mobile view reliably
function togglesToOpen() {
var set = new Set();
// Newer MF markup: <section aria-expanded="false"><h2 class="section-heading">…</h2>
document.querySelectorAll('section[aria-expanded="false"] > .section-heading')
.forEach(function (h) { set.add(h); });
// Classic MF markup: .collapsible-block (content) with a preceding heading toggle
document.querySelectorAll('.collapsible-block').forEach(function (block) {
if (block.classList.contains('open-block')) return; // already open
var prev = block.previousElementSibling;
if (prev && (prev.classList.contains('collapsible-heading') || prev.classList.contains('section-heading'))) {
set.add(prev);
}
});
// Fallback: any collapsed heading control that advertises its state
document.querySelectorAll('.section-heading[aria-expanded="false"]')
.forEach(function (h) { set.add(h); });
return Array.from(set);
}
function click(el) {
el.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, view: window }));
}
function expandAll() {
togglesToOpen().forEach(click);
}
function init() {
expandAll();
// If MF re-renders content (after edits, previews, etc.), expand again
if (window.MutationObserver) {
var obs = new MutationObserver(function () {
var pending = togglesToOpen();
if (pending.length) pending.forEach(click);
});
obs.observe(document.getElementById('content') || document.body, {
subtree: true, childList: true, attributes: true, attributeFilter: ['class', 'aria-expanded']
});
}
}
// Wait for MobileFrontend startup, then run; also run on content refreshes
if (window.mw && mw.loader) {
mw.loader.using('mobile.startup').then(function () {
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', init);
} else {
init();
}
if (mw.hook) mw.hook('wikipage.content').add(init);
});
} else {
// Very defensive fallback
if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', init); else init();
}
})();