MediaWiki:Gadget-toc-progress.js: различия между версиями
Ланселот (обсуждение | вклад) Нет описания правки |
Ланселот (обсуждение | вклад) Нет описания правки |
||
| (не показаны 4 промежуточные версии этого же участника) | |||
| Строка 6: | Строка 6: | ||
* Позиция не выходит за пределы видимой области, при зуме не увеличивается. | * Позиция не выходит за пределы видимой области, при зуме не увеличивается. | ||
* Тёмная тема — по классу html.dm («АСТРЕЯ»). | * Тёмная тема — по классу html.dm («АСТРЕЯ»). | ||
* Идёт в связке с [[MediaWiki:Gadget-toc-progress.css]] | |||
* Лицензия: MIT (opensource.org/license/mit) ==> 2026, absurdopedia.wiki | |||
*/ | */ | ||
( function () { | ( function () { | ||
| Строка 18: | Строка 20: | ||
minHeadingsForToc: 4, | minHeadingsForToc: 4, | ||
minScrollToShow: 0, | minScrollToShow: 0, | ||
autoCollapseMs: | autoCollapseMs: 20000, | ||
storageKey: 'gadget-toc-progress-state', | storageKey: 'gadget-toc-progress-state', | ||
posKey: 'gadget-toc-progress-pos', | posKey: 'gadget-toc-progress-pos', | ||
| Строка 46: | Строка 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: | text: text | ||
}; | }; | ||
} ); | } ); | ||
| Строка 110: | Строка 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 с темой «АСТРЕЯ» ---------- | ||
| Строка 181: | Строка 198: | ||
function applyPos( p ) { | function applyPos( p ) { | ||
var scale = currentScale(); | var scale = currentScale(); | ||
var inv = 1 / scale; | // Компенсируем только увеличение (зум > 1), чтобы кнопка не росла. | ||
var inv = scale > 1 ? 1 / scale : 1; | |||
root.style.transformOrigin = '0 0'; | root.style.transformOrigin = '0 0'; | ||
root.style.transform = | root.style.transform = | ||
'translate(' + p.left + 'px,' + p.top + 'px) scale(' + inv + ')'; | 'translate(' + p.left + 'px,' + p.top + 'px) scale(' + inv + ')'; | ||
// Если панель открыта — пересчитать её позицию относительно кнопки | |||
if ( expanded ) { | |||
positionPanel(); | |||
} | |||
} | } | ||
| Строка 304: | Строка 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' ); | ||
| Строка 337: | Строка 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 ) ) : | 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 ) { | ||
| Строка 362: | Строка 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 ---------- | ||
| Строка 381: | Строка 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; | |||
} | |||
} | } | ||
| Строка 389: | Строка 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 } ) ); | ||
| Строка 425: | Строка 585: | ||
} | } | ||
} ); | } ); | ||
// Пересчёт панели при изменении видимой области | |||
function repositionPanel() { | |||
if ( expanded ) { | |||
positionPanel(); | |||
} | |||
} | |||
if ( window.visualViewport ) { | |||
window.visualViewport.addEventListener( 'resize', repositionPanel ); | |||
} | |||
window.addEventListener( 'resize', repositionPanel ); | |||
// ---------- 9. Старт ---------- | // ---------- 9. Старт ---------- | ||