MediaWiki:Gadget-toc-progress.js: различия между версиями
Ланселот (обсуждение | вклад) Нет описания правки Метка: отменено |
Ланселот (обсуждение | вклад) Нет описания правки |
||
| (не показано 6 промежуточных версий этого же участника) | |||
| Строка 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: | 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', | ||
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: | text: text | ||
}; | }; | ||
} ); | } ); | ||
| Строка 58: | Строка 66: | ||
} | } | ||
var standardToc = document.querySelector( '.toc, #toc' ); | |||
if ( !standardToc ) { | |||
// Заголовков достаточно (>=4), но TOC нет → __NOTOC__. Не показываем гаджет. | |||
// | return; | ||
} | |||
// Скрываем стандартный TOC | // Скрываем стандартный TOC | ||
| Строка 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; } | ||
// | var vv = window.visualViewport || null; | ||
function | var useVV = CONFIG.useVisualViewport && vv; | ||
// Текущий масштаб (1 на десктопе и без зума) | |||
function currentScale() { | |||
return useVV ? vv.scale : 1; | |||
} | } | ||
function | // Видимая область в координатах layout viewport | ||
function viewRect() { | |||
return { left: | 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 | 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( | return { w: w, h: h }; | ||
var maxTop = Math.max( | } | ||
// Клампинг в координатах 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( | left: Math.min( Math.max( vr.left, p.left ), maxLeft ), | ||
top: Math.min( Math.max( | 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 | var s = btnSize(); | ||
var | var vr = viewRect(); | ||
return clamp( { | return clamp( { | ||
left: | left: vr.left + vr.width - s.w - 16, | ||
top: Math.round( ( | 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 | function onViewportChange() { | ||
if ( wasUserMoved ) { | if ( wasUserMoved ) { | ||
applyPos( clamp( currentPos() ) ); | applyPos( clamp( currentPos() ) ); | ||
| Строка 243: | Строка 302: | ||
} | } | ||
} | } | ||
window.addEventListener( 'resize', | |||
window.addEventListener( 'orientationchange', | if ( useVV ) { | ||
vv.addEventListener( 'resize', onViewportChange ); | |||
vv.addEventListener( 'scroll', onViewportChange ); | |||
} | |||
window.addEventListener( 'resize', onViewportChange ); | |||
window.addEventListener( 'orientationchange', onViewportChange ); | |||
// Подавляем click после перетаскивания | // Подавляем click после перетаскивания | ||
| Строка 255: | Строка 319: | ||
}, true ); | }, true ); | ||
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 ) ) : | 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. Старт ---------- | ||