MediaWiki:Gadget-toc-progress.js

Версия от 12:36, 12 ноября 2026; Ланселот (обсуждение | вклад) (Новая страница: «→* * Gadget: toc-progress * Плавающее оглавление с прогрессом чтения. * Заменяет стандартный TOC; уважает __NOTOC__.: ( function () { 'use strict'; // ---------- Конфигурация ---------- var CONFIG = { articleSelector: '#mw-content-text', headingSelector: 'h2, h3', excludeSelector: '.infobox, .navbox, .toc, .mw-editsection, ' + '.references, .reflist, .gadget-toc, .n...»)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

Замечание: Возможно, после публикации вам придётся очистить кэш своего браузера, чтобы увидеть изменения.

  • Firefox / Safari: Удерживая клавишу Shift, нажмите на панели инструментов Обновить либо нажмите Ctrl+F5 или Ctrl+R (⌘+R на Mac)
  • Google Chrome: Нажмите Ctrl+Shift+R (⌘+Shift+R на Mac)
  • Edge: Удерживая Ctrl, нажмите Обновить либо нажмите Ctrl+F5
  • Opera: Нажмите Ctrl+F5.
/**
 * Gadget: toc-progress
 * Плавающее оглавление с прогрессом чтения.
 * Заменяет стандартный TOC; уважает __NOTOC__.
 */
( function () {
	'use strict';

	// ---------- Конфигурация ----------
	var CONFIG = {
		articleSelector: '#mw-content-text',
		headingSelector: 'h2, h3',
		excludeSelector: '.infobox, .navbox, .toc, .mw-editsection, ' +
			'.references, .reflist, .gadget-toc, .navbox-styles, .metadata',
		minHeadingsForToc: 4,
		minScrollToShow: 200,
		autoCollapseMs: 8000,
		storageKey: 'gadget-toc-progress-state',
		headerOffset: 64,
		ringRadius: 15
	};

	var article = document.querySelector( CONFIG.articleSelector );
	if ( !article ) {
		return;
	}

	// ---------- 1. Сбор заголовков ----------
	function slug( s ) {
		return s.trim().toLowerCase()
			.replace( /[^\w\u0400-\u04FF]+/g, '-' )
			.replace( /^-+|-+$/g, '' );
	}

	var headings = Array.prototype.slice.call(
		article.querySelectorAll( CONFIG.headingSelector )
	).filter( function ( h ) {
		return !h.closest( CONFIG.excludeSelector );
	} ).map( function ( h, i ) {
		if ( !h.id ) {
			h.id = slug( h.textContent ) || ( 'section-' + i );
		}
		return {
			id: h.id,
			el: h,
			level: h.tagName === 'H2' ? 2 : 3,
			text: h.textContent.trim()
		};
	} );

	// ---------- 2. Проверка условий показа ----------
	if ( headings.length < CONFIG.minHeadingsForToc ) {
		return;
	}

	var standardToc = document.querySelector( '.toc, #toc' );
	if ( !standardToc ) {
		// Заголовков достаточно, но TOC нет → __NOTOC__. Не показываем гаджет.
		return;
	}

	// Скрываем стандартный TOC
	var hideStyle = document.createElement( 'style' );
	hideStyle.textContent = '.toc, #toc { display: none !important; }';
	document.head.appendChild( hideStyle );

	// ---------- 3. Состояние ----------
	var state = {};
	try {
		state = JSON.parse( localStorage.getItem( CONFIG.storageKey ) || '{}' );
	} catch ( e ) {
		state = {};
	}
	var expanded = !!state.expanded;
	var autoCollapseTimer = null;

	function prefersReduced() {
		return window.matchMedia( '(prefers-reduced-motion: reduce)' ).matches;
	}

	// ---------- 4. Разметка ----------
	var root = document.createElement( 'div' );
	root.className = 'gadget-toc';
	root.innerHTML =
		'<button class="gadget-toc__btn" aria-expanded="false" aria-label="Оглавление и прогресс чтения">' +
			'<svg class="gadget-toc__ring" viewBox="0 0 36 36" aria-hidden="true">' +
				'<circle class="gadget-toc__ring-bg" cx="18" cy="18" r="15"></circle>' +
				'<circle class="gadget-toc__ring-fg" cx="18" cy="18" r="15"></circle>' +
			'</svg>' +
			'<span class="gadget-toc__pct">0%</span>' +
		'</button>' +
		'<nav class="gadget-toc__panel" aria-label="Оглавление статьи" hidden>' +
			'<div class="gadget-toc__head">' +
				'<span>Содержание</span>' +
				'<button class="gadget-toc__close" aria-label="Закрыть">×</button>' +
			'</div>' +
			'<ol class="gadget-toc__list"></ol>' +
		'</nav>';
	document.body.appendChild( root );

	var btn = root.querySelector( '.gadget-toc__btn' );
	var panel = root.querySelector( '.gadget-toc__panel' );
	var list = root.querySelector( '.gadget-toc__list' );
	var pct = root.querySelector( '.gadget-toc__pct' );
	var ringFg = root.querySelector( '.gadget-toc__ring-fg' );
	var closeBtn = root.querySelector( '.gadget-toc__close' );

	// ---------- 5. Список ----------
	var links = {};
	headings.forEach( function ( h ) {
		var li = document.createElement( 'li' );
		li.className = 'gadget-toc__item' + ( h.level === 3 ? ' gadget-toc__item--sub' : '' );
		var a = document.createElement( 'a' );
		a.href = '#' + h.id;
		a.textContent = h.text;
		a.dataset.id = h.id;
		a.addEventListener( 'click', function ( e ) {
			e.preventDefault();
			h.el.scrollIntoView( {
				behavior: prefersReduced() ? 'auto' : 'smooth',
				block: 'start'
			} );
			if ( window.history && window.history.replaceState ) {
				window.history.replaceState( null, '', '#' + h.id );
			}
			setActive( h.id );
			if ( window.innerWidth < 720 ) {
				setExpanded( false );
			}
		} );
		li.appendChild( a );
		list.appendChild( li );
		links[ h.id ] = a;
	} );

	// ---------- 6. Прогресс ----------
	var RING_LEN = 2 * Math.PI * CONFIG.ringRadius;
	ringFg.style.strokeDasharray = RING_LEN;

	function updateProgress() {
		var doc = document.documentElement;
		var max = doc.scrollHeight - window.innerHeight;
		var p = max > 0 ? Math.min( 1, Math.max( 0, window.scrollY / max ) ) : 0;
		pct.textContent = Math.round( p * 100 ) + '%';
		ringFg.style.strokeDashoffset = RING_LEN * ( 1 - p );
		root.classList.toggle( 'is-visible', window.scrollY > CONFIG.minScrollToShow );

		headings.forEach( function ( h ) {
			var done = h.el.getBoundingClientRect().bottom < 0;
			var a = links[ h.id ];
			if ( a ) {
				a.classList.toggle( 'is-done', done );
			}
		} );
	}

	var ticking = false;
	window.addEventListener( 'scroll', function () {
		if ( !ticking ) {
			ticking = true;
			window.requestAnimationFrame( function () {
				updateProgress();
				ticking = false;
			} );
		}
	}, { passive: true } );
	window.addEventListener( 'resize', updateProgress );

	// ---------- 7. Scroll-spy ----------
	function setActive( id ) {
		Object.keys( links ).forEach( function ( key ) {
			var on = key === id;
			links[ key ].classList.toggle( 'is-active', on );
			links[ key ].setAttribute( 'aria-current', on ? 'location' : 'false' );
		} );
	}

	if ( 'IntersectionObserver' in window ) {
		var io = new IntersectionObserver( function ( entries ) {
			entries.forEach( function ( e ) {
				if ( e.isIntersecting ) {
					setActive( e.target.id );
				}
			} );
		}, { rootMargin: '-' + ( CONFIG.headerOffset + 8 ) + 'px 0px -70% 0px' } );
		headings.forEach( function ( h ) { io.observe( h.el ); } );
	}

	// ---------- 8. Свернуть/развернуть ----------
	function setExpanded( v ) {
		expanded = v;
		root.classList.toggle( 'is-open', v );
		panel.hidden = !v;
		btn.setAttribute( 'aria-expanded', String( v ) );
		try {
			localStorage.setItem( CONFIG.storageKey, JSON.stringify( { expanded: v } ) );
		} catch ( e ) { /* ignore */ }
		if ( v ) {
			scheduleAutoCollapse();
		} else {
			clearTimeout( autoCollapseTimer );
		}
	}

	function scheduleAutoCollapse() {
		clearTimeout( autoCollapseTimer );
		autoCollapseTimer = setTimeout( function () {
			if ( window.innerWidth >= 720 ) {
				setExpanded( false );
			}
		}, CONFIG.autoCollapseMs );
	}

	btn.addEventListener( 'click', function () {
		setExpanded( !expanded );
	} );
	closeBtn.addEventListener( 'click', function () {
		setExpanded( false );
	} );
	document.addEventListener( 'click', function ( e ) {
		if ( expanded && !root.contains( e.target ) ) {
			setExpanded( false );
		}
	} );
	document.addEventListener( 'keydown', function ( e ) {
		if ( e.key === 'Escape' && expanded ) {
			setExpanded( false );
			btn.focus();
		}
	} );

	// ---------- 9. Старт ----------
	setExpanded( expanded );
	updateProgress();
}() );