MediaWiki:Gadget-autosave.js: различия между версиями
Ланселот (обсуждение | вклад) Нет описания правки |
Ланселот (обсуждение | вклад) Нет описания правки |
||
| (не показаны 3 промежуточные версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
// ================================================= | |||
// === «Автосохранение вики-черновиков» === | |||
// ================================================= | |||
// Версия 2.0, улучшенная и исправленная | |||
// Идёт в связке с [[MediaWiki:Gadget-autosave.css]] | |||
// Лицензия: MIT (opensource.org/license/mit) ==> 2026, absurdopedia.wiki | |||
// Поддерживает движки от MediaWiki 1.35+ | |||
// Автосохранение срабатывает через 3 сек. после того, как вы перестали печатать | |||
// При выходе со страницы сохранение происходит мгновенно | |||
// Ручное сохранение — только Ctrl+S (Cmd+S на Mac) | |||
// Индикатор показывает «Редактирование…» пока вы печатаете, и иное по делу | |||
// Работает без интернета, если страница редактирования уже загружена | |||
// Не нагружает сервер: всё хранится в localStorage браузера | |||
// При сбое ломается только сам скрипт, страница продолжает работать | |||
// Сохраняется текст и для несозданных (новых) статей — ключ привязан к имени страницы | |||
// Черновики разделов хранятся отдельно: правка раздела 1 не предлагается в разделе 2 | |||
// Очистка кэша браузера НЕ удаляет черновики | |||
// История браузера (Ctrl+Shift+Del с галочкой «Данные сайтов») удалит черновики | |||
// В браузерном режиме инкогнито черновики живут до закрытия окна | |||
// Черновики старше 7 дней удаляются при следующей попытке загрузки | |||
// Браузер может удалить данные при переполнении своего хранилища для сайта (квота ~5 МБ) | |||
// Ключ хранилища включает имя вики, имя страницы, номер и заголовок раздела | |||
( function () { | ( function () { | ||
'use strict'; | 'use strict'; | ||
| Строка 7: | Строка 31: | ||
var wgPageName = mw.config.get( 'wgPageName' ); | var wgPageName = mw.config.get( 'wgPageName' ); | ||
var wgDBname = mw.config.get( 'wgDBname' ) || 'wiki'; | var wgDBname = mw.config.get( 'wgDBname' ) || 'wiki'; | ||
var allowedActions = [ 'edit', 'submit', 'editredlink', 'formedit' ]; | var allowedActions = [ 'edit', 'submit', 'editredlink', 'formedit' ]; | ||
| Строка 21: | Строка 44: | ||
}; | }; | ||
// | // ---- Определение раздела ---- | ||
function detectSection() { | |||
var fromUrl = null; | |||
try { | |||
var params = new URLSearchParams( window.location.search ); | |||
if ( params.has( 'section' ) ) fromUrl = params.get( 'section' ); | |||
} catch ( e ) {} | |||
if ( fromUrl === null || fromUrl === undefined || fromUrl === '' ) { | |||
fromUrl = mw.config.get( 'wgSection' ); | |||
} | |||
if ( fromUrl === undefined || fromUrl === null || fromUrl === '' || | |||
fromUrl === 0 || fromUrl === '0' ) { | |||
return 'all'; | |||
} | |||
return String( fromUrl ); | |||
} | |||
function detectSectionTitle() { | |||
var $h = $( '.mw-editform legend, .mw-editform h2, .mw-section-editing-header, #mw-section-editing-header' ).first(); | |||
if ( $h.length ) { | |||
var txt = $h.text().trim(); | |||
if ( txt ) return txt; | |||
} | |||
return 'all'; | |||
} | |||
var storageKey = 'wiki_draft_' + wgDBname + '_' + wgPageName + '_sec' + sectionPart; | var sectionPart = detectSection(); | ||
var sectionTitle = detectSectionTitle(); | |||
var storageKey = 'wiki_draft_' + wgDBname + '_' + wgPageName + | |||
'_sec' + sectionPart + | |||
'_' + sectionTitle.replace( /\s+/g, '_' ).slice( 0, 40 ); | |||
var $textbox = null; | var $textbox = null; | ||
| Строка 50: | Строка 97: | ||
} )(); | } )(); | ||
// ---- Уведомления | // ---- Уведомления ---- | ||
function toast( message, color ) { | function toast( message, color ) { | ||
var $t = $( '<div>' ). | var $t = $( '<div>' ).addClass( 'autosave-toast' ).text( message ); | ||
if ( color ) $t.css( 'border-left-color', color ); | |||
$( document.body ).append( $t ); | $( document.body ).append( $t ); | ||
setTimeout( function () { | setTimeout( function () { | ||
$t. | $t.addClass( 'autosave-toast--hide' ); | ||
setTimeout( function () { $t.remove(); }, 300 ); | setTimeout( function () { $t.remove(); }, 300 ); | ||
}, 2500 ); | }, 2500 ); | ||
| Строка 79: | Строка 113: | ||
function buildIndicator() { | function buildIndicator() { | ||
if ( $indicator ) return; | if ( $indicator ) return; | ||
$indicator = $( '<div>' ).attr( 'id', 'autosave-indicator' ). | $indicator = $( '<div>' ).attr( 'id', 'autosave-indicator' ).addClass( 'autosave-panel' ); | ||
var $text = $( '<span>' ).attr( 'id', 'autosave-text' ) | |||
.addClass( 'autosave-panel-text' ).text( 'Черновик пуст' ); | |||
var $restore = $( '<button>' ).attr( 'type', 'button' ).attr( 'id', 'autosave-restore' ) | |||
var $restore = $( '<button>' ).attr( 'type', 'button' ).attr( 'id', 'autosave-restore' ). | .addClass( 'autosave-btn autosave-btn--primary' ) | ||
.css( { display: 'none', marginLeft: 'auto' } ) | |||
.text( 'Восстановить' ) | |||
.on( 'click', openDraftDialog ); | |||
$indicator.append( $text, $restore ); | $indicator.append( $text, $restore ); | ||
| Строка 114: | Строка 131: | ||
if ( !$indicator ) return; | if ( !$indicator ) return; | ||
var map = { | var map = { | ||
saved: { t: 'Черновик сохранён', | saved: { t: 'Черновик сохранён', cls: 'autosave-panel--saved' }, | ||
editing: { t: 'Редактирование…', | editing: { t: 'Редактирование…', cls: 'autosave-panel--editing' }, | ||
error: { t: 'Ошибка сохранения', | error: { t: 'Ошибка сохранения', cls: 'autosave-panel--error' }, | ||
idle: { t: 'Черновик | idle: { t: 'Черновик пуст', cls: 'autosave-panel--idle' }, | ||
found: { t: 'Найден черновик', | found: { t: 'Найден черновик', cls: 'autosave-panel--found' } | ||
}; | }; | ||
var m = map[ status ] || map.idle; | var m = map[ status ] || map.idle; | ||
$indicator. | $indicator | ||
.removeClass( 'autosave-panel--saved autosave-panel--editing autosave-panel--error autosave-panel--idle autosave-panel--found' ) | |||
.addClass( m.cls ); | |||
$indicator.find( '#autosave-text' ).text( m.t ); | |||
} | } | ||
function toggleRestoreBtn( show ) { | function toggleRestoreBtn( show ) { | ||
if ( $indicator ) $indicator.find( '#autosave-restore' ).css( | if ( !$indicator ) return; | ||
var $b = $indicator.find( '#autosave-restore' ); | |||
if ( show ) { | |||
$b.css( { display: 'inline-block', marginLeft: 'auto' } ); | |||
} else { | |||
$b.css( 'display', 'none' ); | |||
} | |||
} | } | ||
| Строка 138: | Строка 164: | ||
page: wgPageName, | page: wgPageName, | ||
section: sectionPart, | section: sectionPart, | ||
sectionTitle: sectionTitle, | |||
revId: mw.config.get( 'wgCurRevisionId' ) || 0 | revId: mw.config.get( 'wgCurRevisionId' ) || 0 | ||
}; | }; | ||
| Строка 174: | Строка 201: | ||
function openDraftDialog() { | function openDraftDialog() { | ||
if ( !draftData ) return; | if ( !draftData ) return; | ||
var $ov = $( '<div>' ). | if ( $( '.autosave-overlay' ).length ) return; // защита от повторного открытия | ||
var $ov = $( '<div>' ).addClass( 'autosave-overlay' ); | |||
var $box = $( '<div>' ).addClass( 'autosave-dialog' ); | |||
var $box = $( '<div>' ). | |||
var preview = draftData.content.length > 200 ? draftData.content.slice( 0, 200 ) + '…' : draftData.content; | var preview = draftData.content.length > 200 ? draftData.content.slice( 0, 200 ) + '…' : draftData.content; | ||
var closed = false; | |||
function close() { | |||
if ( closed ) return; | |||
closed = true; | |||
$ov.remove(); | |||
} | |||
var $actions = $( '<div>' ).addClass( 'autosave-dialog-actions' ); | |||
$actions.append( | |||
$( '<button>' ).attr( 'type', 'button' ).addClass( 'autosave-btn autosave-btn--ghost' ) | |||
.text( 'Отмена' ).on( 'click', close ), | |||
$( '<button>' ).attr( 'type', 'button' ).addClass( 'autosave-btn autosave-btn--secondary' ) | |||
.text( 'Удалить' ).on( 'click', function () { | |||
storage.remove( storageKey ); | |||
draftData = null; | |||
updateIndicator( 'idle' ); | |||
toggleRestoreBtn( false ); | |||
close(); | |||
} ), | |||
$( '<button>' ).attr( 'type', 'button' ).addClass( 'autosave-btn autosave-btn--primary' ) | |||
.text( 'Восстановить' ).on( 'click', function () { | |||
applyDraft( draftData ); | |||
close(); | |||
} ) | |||
); | |||
$box.append( | $box.append( | ||
$( '<div>' ). | $( '<div>' ).addClass( 'autosave-dialog-title' ).text( 'Сохранённый черновик' ), | ||
$( '<div>' ). | $( '<div>' ).addClass( 'autosave-dialog-meta' ) | ||
.text( new Date( draftData.timestamp ).toLocaleString() + ' · ' + draftData.content.length + ' симв.' ), | .text( new Date( draftData.timestamp ).toLocaleString() + ' · ' + draftData.content.length + ' симв.' ), | ||
$( '<pre>' ). | $( '<pre>' ).addClass( 'autosave-dialog-preview' ).text( preview ), | ||
$actions | |||
); | ); | ||
$ov.append( $box ).on( 'click', function ( e ) { if ( e.target === $ov[ 0 ] ) $ | |||
$ov.append( $box ).on( 'click', function ( e ) { | |||
if ( e.target === $ov[ 0 ] ) close(); | |||
} ); | |||
// Закрытие по Esc | |||
$( document ).one( 'keydown.autosaveDialog', function ( e ) { | |||
if ( e.key === 'Escape' ) close(); | |||
} ); | |||
$( document.body ).append( $ov ); | $( document.body ).append( $ov ); | ||
} | } | ||
| Строка 226: | Строка 261: | ||
var current = $textbox.val() || ''; | var current = $textbox.val() || ''; | ||
if ( draftData.content === current ) { | if ( draftData.content === current ) { | ||
lastSavedContent = current; updateIndicator( 'saved' ); return; | lastSavedContent = current; | ||
updateIndicator( 'saved' ); | |||
return; | |||
} | } | ||
if ( current.trim() === '' ) { | if ( current.trim() === '' ) { | ||
applyDraft( draftData ); return; | applyDraft( draftData ); | ||
return; | |||
} | |||
if ( draftData.content.trim() === '' ) { | |||
storage.remove( storageKey ); | |||
draftData = null; | |||
updateIndicator( 'idle' ); | |||
return; | |||
} | } | ||
updateIndicator( 'found' ); | updateIndicator( 'found' ); | ||
| Строка 244: | Строка 288: | ||
} ); | } ); | ||
$( document ).on( 'keydown', function ( e ) { | $( document ).on( 'keydown', function ( e ) { | ||
if ( ( e.ctrlKey || e.metaKey ) && ( e.key === 's' || e.key === 'S' ) ) { | if ( ( e.ctrlKey || e.metaKey ) && ( e.key === 's' || e.key === 'S' ) ) { | ||
| Строка 252: | Строка 295: | ||
} ); | } ); | ||
$( window ).on( 'beforeunload', function () { | $( window ).on( 'beforeunload', function () { | ||
if ( !$textbox ) return; | if ( !$textbox ) return; | ||
| Строка 258: | Строка 300: | ||
} ); | } ); | ||
$( document ).on( 'visibilitychange', function () { | $( document ).on( 'visibilitychange', function () { | ||
if ( document.visibilityState === 'hidden' && $textbox && $textbox.val() !== lastSavedContent ) { | if ( document.visibilityState === 'hidden' && $textbox && $textbox.val() !== lastSavedContent ) { | ||
| Строка 265: | Строка 306: | ||
} ); | } ); | ||
$( window ).on( 'pagehide', function () { | $( window ).on( 'pagehide', function () { | ||
if ( $textbox && $textbox.val() !== lastSavedContent ) { | if ( $textbox && $textbox.val() !== lastSavedContent ) { | ||
| Строка 272: | Строка 312: | ||
} ); | } ); | ||
var submitted = false; | var submitted = false; | ||
$( document ).on( 'submit', 'form', function () { | $( document ).on( 'submit', 'form', function () { | ||
| Строка 282: | Строка 321: | ||
} | } | ||
// ---- Ждём | // ---- Ждём textarea ---- | ||
function waitForTextbox( cb ) { | function waitForTextbox( cb ) { | ||
var tries = 0; | var tries = 0; | ||
| Строка 290: | Строка 329: | ||
clearInterval( timer ); | clearInterval( timer ); | ||
cb( $tb ); | cb( $tb ); | ||
} else if ( ++tries > 100 ) { | } else if ( ++tries > 100 ) { | ||
clearInterval( timer ); | clearInterval( timer ); | ||
} | } | ||