MediaWiki:Gadget-toc-progress.js: различия между версиями

Нет описания правки
Метка: ручная отмена
Нет описания правки
 
(не показано 5 промежуточных версий этого же участника)
Строка 3: Строка 3:
  * Плавающее оглавление с прогрессом чтения.
  * Плавающее оглавление с прогрессом чтения.
  * Заменяет стандартный TOC; уважает __NOTOC__.
  * Заменяет стандартный TOC; уважает __NOTOC__.
  * Кнопка перетаскиваемая, по умолчанию — центр правого края.
  * Кнопка перетаскиваемая, видна всегда, по умолчанию — центр правого края.
  * Позиция никогда не выходит за пределы экрана.
  * Позиция не выходит за пределы видимой области, при зуме не увеличивается.
  * Тёмная тема — по классу html.dm («АСТРЕЯ»).
  * Тёмная тема — по классу html.dm («АСТРЕЯ»).
* Идёт в связке с [[MediaWiki:Gadget-toc-progress.css]]
* Лицензия: MIT (opensource.org/license/mit) ==> 2026, absurdopedia.wiki
  */
  */
( function () {
( function () {
Строка 17: Строка 19:
'.references, .reflist, .gadget-toc, .navbox-styles, .metadata',
'.references, .reflist, .gadget-toc, .navbox-styles, .metadata',
minHeadingsForToc: 4,
minHeadingsForToc: 4,
minScrollToShow: 200,
minScrollToShow: 0,
autoCollapseMs: 8000,
autoCollapseMs: 20000,
storageKey: 'gadget-toc-progress-state',
storageKey: 'gadget-toc-progress-state',
posKey: 'gadget-toc-progress-pos',
posKey: 'gadget-toc-progress-pos',
headerOffset: 64,
headerOffset: 64,
ringRadius: 15
ringRadius: 15,
useVisualViewport: true
};
};


Строка 45: Строка 48:
h.id = slug( h.textContent ) || ( 'section-' + i );
h.id = slug( h.textContent ) || ( 'section-' + i );
}
}
// Клон заголовка без [править] и служебных элементов — для чистого текста в оглавлении.
var clone = h.cloneNode( true );
clone.querySelectorAll( '.mw-editsection, .mw-editsection-like' )
.forEach( function ( el ) { el.remove(); } );
var text = ( clone.textContent || '' ).replace( /\s+/g, ' ' ).trim();
return {
return {
id: h.id,
id: h.id,
el: h,
el: h,
level: h.tagName === 'H2' ? 2 : 3,
level: h.tagName === 'H2' ? 2 : 3,
text: h.textContent.trim()
text: text
};
};
} );
} );
Строка 109: Строка 117:
var ringFg = root.querySelector( '.gadget-toc__ring-fg' );
var ringFg = root.querySelector( '.gadget-toc__ring-fg' );
var closeBtn = root.querySelector( '.gadget-toc__close' );
var closeBtn = root.querySelector( '.gadget-toc__close' );
    // Не сворачивать, пока курсор над панелью
    panel.addEventListener( 'mouseenter', function () {
clearTimeout( autoCollapseTimer );
    } );
    panel.addEventListener( 'mouseleave', function () {
  if ( expanded ) {
  scheduleAutoCollapse();
  }
    } );


// ---------- 4a. Синхронизация color-scheme с темой «АСТРЕЯ» ----------
// ---------- 4a. Синхронизация color-scheme с темой «АСТРЕЯ» ----------
Строка 133: Строка 151:
} catch ( e ) { pos = null; }
} catch ( e ) { pos = null; }


// Позиционируем через transform: translate(x, y) от верхнего левого угла.
var vv = window.visualViewport || null;
function applyPos( p ) {
var useVV = CONFIG.useVisualViewport && vv;
root.style.transform = 'translate(' + p.left + 'px,' + p.top + 'px)';
 
// Текущий масштаб (1 на десктопе и без зума)
function currentScale() {
return useVV ? vv.scale : 1;
}
}


function currentPos() {
// Видимая область в координатах layout viewport
var r = root.getBoundingClientRect();
function viewRect() {
return { left: r.left, top: r.top };
if ( useVV ) {
return {
left: vv.offsetLeft,
top: vv.offsetTop,
width: vv.width,
height: vv.height
};
}
return {
left: 0,
top: 0,
width: window.innerWidth,
height: window.innerHeight
};
}
}


function clamp( p ) {
function btnSize() {
var w = btn.offsetWidth || 56;
var w = btn.offsetWidth || 56;
var h = btn.offsetHeight || 56;
var h = btn.offsetHeight || 56;
var maxLeft = Math.max( 0, window.innerWidth - w );
return { w: w, h: h };
var maxTop = Math.max( 0, window.innerHeight - h );
}
 
// Клампинг в координатах layout viewport с учётом видимой области
function clamp( p ) {
var s = btnSize();
var vr = viewRect();
var maxLeft = Math.max( vr.left, vr.left + vr.width - s.w );
var maxTop = Math.max( vr.top, vr.top + vr.height - s.h );
return {
return {
left: Math.min( Math.max( 0, p.left ), maxLeft ),
left: Math.min( Math.max( vr.left, p.left ), maxLeft ),
top: Math.min( Math.max( 0, p.top ), maxTop )
top: Math.min( Math.max( vr.top, p.top ), maxTop )
};
};
}
// Применяем позицию + компенсируем масштаб, чтобы кнопка не росла
function applyPos( p ) {
var scale = currentScale();
// Компенсируем только увеличение (зум > 1), чтобы кнопка не росла.
var inv = scale > 1 ? 1 / scale : 1;
root.style.transformOrigin = '0 0';
root.style.transform =
'translate(' + p.left + 'px,' + p.top + 'px) scale(' + inv + ')';
// Если панель открыта — пересчитать её позицию относительно кнопки
if ( expanded ) {
positionPanel();
}
}
function currentPos() {
var r = root.getBoundingClientRect();
return { left: r.left, top: r.top };
}
}


Строка 160: Строка 220:
}
}


// Дефолтная позиция: по центру по вертикали, у правого края
// Дефолт: центр правого края видимой области
function defaultPos() {
function defaultPos() {
var w = btn.offsetWidth || 56;
var s = btnSize();
var h = btn.offsetHeight || 56;
var vr = viewRect();
return clamp( {
return clamp( {
left: window.innerWidth - w - 16,
left: vr.left + vr.width - s.w - 16,
top: Math.round( ( window.innerHeight - h ) / 2 )
top: vr.top + Math.round( ( vr.height - s.h ) / 2 )
} );
} );
}
}


// Восстановление позиции или дефолт
var wasUserMoved = !!( pos && typeof pos.left === 'number' && typeof pos.top === 'number' );
var wasUserMoved = !!( pos && typeof pos.left === 'number' && typeof pos.top === 'number' );
if ( wasUserMoved ) {
if ( wasUserMoved ) {
Строка 235: Строка 294:
document.addEventListener( 'pointercancel', onUp );
document.addEventListener( 'pointercancel', onUp );


// При любом изменении размеров окна кнопка не уползает за экран.
// Пересчёт при изменении видимой области (зум, скролл, поворот)
function onResize() {
function onViewportChange() {
if ( wasUserMoved ) {
if ( wasUserMoved ) {
applyPos( clamp( currentPos() ) );
applyPos( clamp( currentPos() ) );
Строка 243: Строка 302:
}
}
}
}
window.addEventListener( 'resize', onResize );
 
window.addEventListener( 'orientationchange', onResize );
if ( useVV ) {
vv.addEventListener( 'resize', onViewportChange );
vv.addEventListener( 'scroll', onViewportChange );
}
window.addEventListener( 'resize', onViewportChange );
window.addEventListener( 'orientationchange', onViewportChange );


// Подавляем click после перетаскивания
// Подавляем click после перетаскивания
Строка 255: Строка 319:
}, true );
}, true );


// Если пользователь начал тащить — помечаем, чтобы resize не сбрасывал
btn.addEventListener( 'pointerdown', function () {
btn.addEventListener( 'pointerdown', function () {
wasUserMoved = true;
wasUserMoved = true;
Строка 263: Строка 326:
// ---------- 5. Список ----------
// ---------- 5. Список ----------
var links = {};
var links = {};
    // Пункт «Преамбула» — переход к началу статьи (нулевой раздел)
    var introLi = document.createElement( 'li' );
    introLi.className = 'gadget-toc__item gadget-toc__item--intro';
    var introA = document.createElement( 'a' );
    introA.href = '#';
    introA.textContent = 'Преамбула';
    introA.dataset.id = '__intro__';
    introA.addEventListener( 'click', function ( e ) {
    e.preventDefault();
    article.scrollIntoView( {
behavior: prefersReduced() ? 'auto' : 'smooth',
block: 'start'
} );
if ( window.history && window.history.replaceState ) {
window.history.replaceState( null, '', '#' );
}
    setActive( '__intro__' );
    if ( window.innerWidth < 720 ) {
    setExpanded( false );
    }
    } );
    introLi.appendChild( introA );
    list.appendChild( introLi );
    links[ '__intro__' ] = introA;
headings.forEach( function ( h ) {
headings.forEach( function ( h ) {
var li = document.createElement( 'li' );
var li = document.createElement( 'li' );
Строка 296: Строка 385:
var doc = document.documentElement;
var doc = document.documentElement;
var max = doc.scrollHeight - window.innerHeight;
var max = doc.scrollHeight - window.innerHeight;
var p = max > 0 ? Math.min( 1, Math.max( 0, window.scrollY / max ) ) : 0;
var p = max > 0 ? Math.min( 1, Math.max( 0, window.scrollY / max ) ) : 1;
pct.textContent = Math.round( p * 100 ) + '%';
pct.textContent = Math.round( p * 100 ) + '%';
ringFg.style.strokeDashoffset = RING_LEN * ( 1 - p );
ringFg.style.strokeDashoffset = RING_LEN * ( 1 - p );
root.classList.toggle( 'is-visible', window.scrollY > CONFIG.minScrollToShow );
root.classList.toggle( 'is-visible', window.scrollY >= CONFIG.minScrollToShow );
 
    // При зуме ограничиваем высоту панели видимой областью,
    // чтобы внутренний скролл доходил до конца.
    if ( expanded && window.visualViewport && window.visualViewport.scale > 1 ) {
    var vv = window.visualViewport;
    var b = btn.getBoundingClientRect();
    var available = vv.offsetTop + vv.height - b.bottom - 8;
    var scale = vv.scale;
    panel.style.maxHeight = Math.max( 120, available * scale ) + 'px';
    } else if ( expanded ) {
    panel.style.maxHeight = '';
    }


headings.forEach( function ( h ) {
headings.forEach( function ( h ) {
Строка 321: Строка 422:
}, { passive: true } );
}, { passive: true } );
window.addEventListener( 'resize', updateProgress );
window.addEventListener( 'resize', updateProgress );
    // Если мы выше первого заголовка — активна «Преамбула»
        if ( headings.length ) {
    var firstTop = headings[ 0 ].el.getBoundingClientRect().top;
    if ( firstTop > CONFIG.headerOffset ) {
    setActive( '__intro__' );
    }
    }


// ---------- 7. Scroll-spy ----------
// ---------- 7. Scroll-spy ----------
Строка 340: Строка 449:
}, { rootMargin: '-' + ( CONFIG.headerOffset + 8 ) + 'px 0px -70% 0px' } );
}, { rootMargin: '-' + ( CONFIG.headerOffset + 8 ) + 'px 0px -70% 0px' } );
headings.forEach( function ( h ) { io.observe( h.el ); } );
headings.forEach( function ( h ) { io.observe( h.el ); } );
}
// ---------- 7b. Авто-позиционирование панели ----------
// Открывает панель в ту сторону от кнопки, где есть место,
// и клампит её по видимой области. На мобильном (bottom-sheet) не трогает.
function positionPanel() {
if ( window.innerWidth < 720 ) {
// Мобильный bottom-sheet — позиционируется CSS
panel.style.transform = '';
return;
}
var vv = window.visualViewport || null;
var useVV = CONFIG.useVisualViewport && vv;
// Видимая область
var vr = useVV ? {
left: vv.offsetLeft,
top: vv.offsetTop,
width: vv.width,
height: vv.height
} : {
left: 0,
top: 0,
width: window.innerWidth,
height: window.innerHeight
};
// Размеры кнопки
var b = btn.getBoundingClientRect();
// Панель измеряем до позиционирования — временно показываем
var wasHidden = panel.hidden;
panel.hidden = false;
panel.style.transform = 'translate(0,0)';
var pw = panel.offsetWidth || 280;
var ph = panel.offsetHeight || 300;
var gap = 8; // отступ между кнопкой и панелью
// Куда открывать по вертикали: вниз, если есть место, иначе вверх
var spaceBelow = vr.top + vr.height - ( b.bottom + gap );
var spaceAbove = ( b.top - gap ) - vr.top;
var openBelow = spaceBelow >= ph || spaceBelow >= spaceAbove;
var top;
if ( openBelow ) {
top = b.bottom + gap;
} else {
top = b.top - gap - ph;
}
// Куда открывать по горизонтали: вправо от кнопки,
// если не влезает — влево.
var spaceRight = vr.left + vr.width - b.right;
var spaceLeft = b.left - vr.left;
var openRight = spaceRight >= pw || spaceRight >= spaceLeft;
var left;
if ( openRight ) {
left = b.right + gap;
} else {
left = b.left - gap - pw;
}
// Клампим по видимой области
var maxLeft = vr.left + vr.width - pw;
var maxTop = vr.top + vr.height - ph;
left = Math.min( Math.max( vr.left, left ), Math.max( vr.left, maxLeft ) );
top = Math.min( Math.max( vr.top, top ), Math.max( vr.top, maxTop ) );
// translate задаём относительно root (у него transform = translate кнопки).
// Панель — дочерний элемент root, поэтому её координаты абсолютные
// внутри root; вычитаем позицию root.
var r = root.getBoundingClientRect();
var relLeft = left - r.left;
var relTop = top - r.top;
// Компенсируем масштаб, чтобы панель не росла при зуме
var scale = useVV ? vv.scale : 1;
var inv = scale > 1 ? 1 / scale : 1;
panel.style.transformOrigin = '0 0';
panel.style.transform =
'translate(' + relLeft + 'px,' + relTop + 'px) scale(' + inv + ')';
if ( wasHidden ) {
panel.hidden = true;
}
}
}


Строка 348: Строка 546:
panel.hidden = !v;
panel.hidden = !v;
btn.setAttribute( 'aria-expanded', String( v ) );
btn.setAttribute( 'aria-expanded', String( v ) );
if ( v ) {
positionPanel();
}
try {
try {
localStorage.setItem( CONFIG.storageKey, JSON.stringify( { expanded: v } ) );
localStorage.setItem( CONFIG.storageKey, JSON.stringify( { expanded: v } ) );
Строка 384: Строка 585:
}
}
} );
} );
// Пересчёт панели при изменении видимой области
function repositionPanel() {
if ( expanded ) {
positionPanel();
}
}
if ( window.visualViewport ) {
window.visualViewport.addEventListener( 'resize', repositionPanel );
}
window.addEventListener( 'resize', repositionPanel );


// ---------- 9. Старт ----------
// ---------- 9. Старт ----------