MediaWiki:Gadget-autosave.js: различия между версиями
Ланселот (обсуждение | вклад) Новая страница: «( function () { 'use strict'; // ---- Проверки окружения ---- var wgAction = mw.config.get( 'wgAction' ); var wgNamespace = mw.config.get( 'wgNamespaceNumber' ); var wgPageName = mw.config.get( 'wgPageName' ); var wgDBname = mw.config.get( 'wgDBname' ) || 'wiki'; // Разрешаем: обычное редактирование, submit, редактирование новой/красной ссылки. //...» |
Ланселот (обсуждение | вклад) Нет описания правки |
||
| (не показано 6 промежуточных версий этого же участника) | |||
| Строка 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'; | ||
// ---- | // ---- Окружение ---- | ||
var wgAction = mw.config.get( 'wgAction' ); | var wgAction = mw.config.get( 'wgAction' ); | ||
var wgNamespace = mw.config.get( 'wgNamespaceNumber' ); | var wgNamespace = mw.config.get( 'wgNamespaceNumber' ); | ||
| Строка 8: | Строка 32: | ||
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' ]; | ||
if ( allowedActions.indexOf( wgAction ) === -1 ) | if ( allowedActions.indexOf( wgAction ) === -1 ) return; | ||
if ( wgNamespace === -1 ) return; | |||
if ( mw.config.get( 'wgVisualEditorActive' ) ) return; | |||
if ( wgNamespace === -1 ) { | |||
// ---- Конфиг ---- | |||
} | var config = { | ||
saveDelay: 3000, | |||
return; | maxDraftAgeDays: 7, | ||
highlightMs: 2000 | |||
}; | |||
// ---- Определение раздела ---- | |||
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 ); | |||
} | } | ||
var $ | function detectSectionTitle() { | ||
var $h = $( '.mw-editform legend, .mw-editform h2, .mw-section-editing-header, #mw-section-editing-header' ).first(); | |||
return; | if ( $h.length ) { | ||
var txt = $h.text().trim(); | |||
if ( txt ) return txt; | |||
} | |||
return 'all'; | |||
} | } | ||
var sectionPart = detectSection(); | |||
var | var sectionTitle = detectSectionTitle(); | ||
var storageKey = 'wiki_draft_' + wgDBname + '_' + wgPageName + | |||
'_sec' + sectionPart + | |||
'_' + sectionTitle.replace( /\s+/g, '_' ).slice( 0, 40 ); | |||
var storageKey = 'wiki_draft_' + wgDBname + '_' + wgPageName | |||
var $textbox = null; | |||
var saveTimeout = null; | var saveTimeout = null; | ||
var | var lastSavedContent = ''; | ||
var | var draftData = null; | ||
// ---- | // ---- localStorage ---- | ||
var storage = | var storage = ( function () { | ||
var ok = false; | |||
try { | |||
localStorage.setItem( '__t__', '1' ); | |||
localStorage.removeItem( '__t__' ); | |||
ok = true; | |||
} catch ( e ) {} | |||
return { | |||
ok: ok, | |||
get: function ( k ) { try { return ok ? localStorage.getItem( k ) : null; } catch ( e ) { return null; } }, | |||
set: function ( k, v ) { try { return ok ? ( localStorage.setItem( k, v ), true ) : false; } catch ( e ) { return false; } }, | |||
remove: function ( k ) { try { if ( ok ) localStorage.removeItem( k ); } catch ( e ) {} } | |||
}; | |||
} )(); | |||
// ---- Уведомления ---- | |||
function toast( message, color ) { | |||
var $t = $( '<div>' ).addClass( 'autosave-toast' ).text( message ); | |||
if ( color ) $t.css( 'border-left-color', color ); | |||
$( document.body ).append( $t ); | |||
setTimeout( function () { | |||
$t.addClass( 'autosave-toast--hide' ); | |||
} | setTimeout( function () { $t.remove(); }, 300 ); | ||
} | }, 2500 ); | ||
} | |||
// ---- | // ---- Панель ---- | ||
var $indicator = null; | var $indicator = null; | ||
function | function buildIndicator() { | ||
if ( $( ' | if ( $indicator ) return; | ||
$indicator = $( '<div>' ).attr( 'id', 'autosave-indicator' ).addClass( 'autosave-panel' ); | |||
$ | var $text = $( '<span>' ).attr( 'id', 'autosave-text' ) | ||
.addClass( 'autosave-panel-text' ).text( 'Черновик пуст' ); | |||
. | |||
var $ | var $restore = $( '<button>' ).attr( 'type', 'button' ).attr( 'id', 'autosave-restore' ) | ||
.addClass( 'autosave-btn autosave-btn--primary' ) | |||
.css( { display: 'none', marginLeft: 'auto' } ) | |||
. | |||
.css( { | |||
.text( 'Восстановить' ) | .text( 'Восстановить' ) | ||
.on( 'click', | .on( 'click', openDraftDialog ); | ||
$indicator.append( | $indicator.append( $text, $restore ); | ||
$textbox.after( $indicator ); | $textbox.after( $indicator ); | ||
} | } | ||
function updateIndicator( status ) { | function updateIndicator( status ) { | ||
if ( !$indicator | if ( !$indicator ) return; | ||
var map = { | |||
saved: { t: 'Черновик сохранён', cls: 'autosave-panel--saved' }, | |||
editing: { t: 'Редактирование…', cls: 'autosave-panel--editing' }, | |||
error: { t: 'Ошибка сохранения', cls: 'autosave-panel--error' }, | |||
idle: { t: 'Черновик пуст', cls: 'autosave-panel--idle' }, | |||
var | found: { t: 'Найден черновик', cls: 'autosave-panel--found' } | ||
saved: { | |||
editing: { | |||
error: { | |||
idle: { | |||
found: { | |||
}; | }; | ||
var m = map[ status ] || map.idle; | |||
$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 ) { | |||
$indicator | if ( !$indicator ) return; | ||
$indicator.find( '#autosave- | var $b = $indicator.find( '#autosave-restore' ); | ||
if ( show ) { | |||
$b.css( { display: 'inline-block', marginLeft: 'auto' } ); | |||
} else { | |||
$b.css( 'display', 'none' ); | |||
} | } | ||
} | } | ||
// ---- Сохранение ---- | // ---- Сохранение ---- | ||
function saveDraft( silent ) { | function saveDraft( silent ) { | ||
if ( !storage. | if ( !storage.ok || !$textbox ) return false; | ||
var content = $textbox.val(); | |||
if ( content === lastSavedContent ) return false; | |||
var data = { | |||
content: content, | |||
var | timestamp: Date.now(), | ||
if ( | page: wgPageName, | ||
section: sectionPart, | |||
sectionTitle: sectionTitle, | |||
revId: mw.config.get( 'wgCurRevisionId' ) || 0 | |||
}; | |||
if ( storage.set( storageKey, JSON.stringify( data ) ) ) { | |||
lastSavedContent = content; | |||
lastSavedContent = | |||
updateIndicator( 'saved' ); | updateIndicator( 'saved' ); | ||
return true; | return true; | ||
} | } | ||
updateIndicator( 'error' ); | |||
if ( !silent ) toast( 'Не удалось сохранить черновик', '#d33' ); | |||
return false; | |||
} | } | ||
// ---- | // ---- Чтение черновика ---- | ||
function loadDraft() { | function loadDraft() { | ||
var raw = storage.get( storageKey ); | var raw = storage.get( storageKey ); | ||
if ( !raw ) return null; | if ( !raw ) return null; | ||
var data; | var data; | ||
try { | try { data = JSON.parse( raw ); } catch ( e ) { storage.remove( storageKey ); return null; } | ||
if ( !data || data.page !== wgPageName || typeof data.content !== 'string' ) return null; | |||
var ageDays = ( Date.now() - data.timestamp ) / 86400000; | |||
if ( ageDays > config.maxDraftAgeDays ) { storage.remove( storageKey ); return null; } | |||
if ( !data || data.page !== wgPageName || typeof data.content !== 'string' ) | |||
var ageDays = ( Date.now() - data.timestamp ) / | |||
if ( ageDays > config.maxDraftAgeDays ) { | |||
return data; | return data; | ||
} | } | ||
function applyDraft( | function applyDraft( d ) { | ||
$textbox.val( | $textbox.val( d.content ); | ||
lastSavedContent = | lastSavedContent = d.content; | ||
$textbox.addClass( 'autosave-restored' ); | $textbox.addClass( 'autosave-restored' ); | ||
setTimeout( function () { | setTimeout( function () { $textbox.removeClass( 'autosave-restored' ); }, config.highlightMs ); | ||
toast( 'Черновик восстановлен', '#00af89' ); | |||
updateIndicator( 'saved' ); | updateIndicator( 'saved' ); | ||
} | } | ||
// ---- | // ---- Диалог выбора ---- | ||
function openDraftDialog() { | function openDraftDialog() { | ||
if ( !draftData ) return; | if ( !draftData ) return; | ||
if ( $( '.autosave-overlay' ).length ) return; // защита от повторного открытия | |||
var $ | var $ov = $( '<div>' ).addClass( 'autosave-overlay' ); | ||
var $box = $( '<div>' ).addClass( 'autosave-dialog' ); | |||
var | var preview = draftData.content.length > 200 ? draftData.content.slice( 0, 200 ) + '…' : draftData.content; | ||
var | var closed = false; | ||
function close() { | |||
if ( closed ) return; | |||
closed = true; | |||
$ov.remove(); | |||
} | |||
var | 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( | |||
$( '<div>' ).addClass( 'autosave-dialog-title' ).text( 'Сохранённый черновик' ), | |||
$( '<div>' ).addClass( 'autosave-dialog-meta' ) | |||
.text( new Date( draftData.timestamp ).toLocaleString() + ' · ' + draftData.content.length + ' симв.' ), | |||
$( '<pre>' ).addClass( 'autosave-dialog-preview' ).text( preview ), | |||
$actions | |||
); | |||
$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(); | |||
if ( e. | |||
} ); | } ); | ||
$( document.body ).append( $ | $( document.body ).append( $ov ); | ||
} | } | ||
| Строка 370: | Строка 258: | ||
function initDraft() { | function initDraft() { | ||
draftData = loadDraft(); | draftData = loadDraft(); | ||
if ( !draftData ) { | if ( !draftData ) { updateIndicator( 'idle' ); return; } | ||
updateIndicator( ' | var current = $textbox.val() || ''; | ||
if ( draftData.content === current ) { | |||
lastSavedContent = current; | |||
updateIndicator( 'saved' ); | |||
return; | return; | ||
} | } | ||
if ( current.trim() === '' ) { | |||
applyDraft( draftData ); | |||
return; | return; | ||
} | } | ||
if ( draftData.content.trim() === '' ) { | |||
if ( | storage.remove( storageKey ); | ||
draftData = null; | |||
updateIndicator( 'idle' ); | |||
return; | return; | ||
} | } | ||
updateIndicator( 'found' ); | updateIndicator( 'found' ); | ||
toggleRestoreBtn( true ); | |||
toast( 'Найден черновик — нажмите «Восстановить»', '#ac6600' ); | |||
} | } | ||
// ---- | // ---- Обработчики ---- | ||
function | function bindEvents() { | ||
$textbox.on( 'input', function () { | |||
if ( saveTimeout ) clearTimeout( saveTimeout ); | |||
updateIndicator( 'editing' ); | |||
saveTimeout = setTimeout( function () { saveDraft( true ); }, config.saveDelay ); | |||
} ); | } ); | ||
$( document ).on( 'keydown', function ( e ) { | |||
if ( ( e.ctrlKey || e.metaKey ) && ( e.key === 's' || e.key === 'S' ) ) { | |||
e.preventDefault(); | |||
$( | if ( saveDraft( false ) ) toast( 'Черновик сохранён', '#00af89' ); | ||
} | } | ||
} ); | } ); | ||
$( window ).on( 'beforeunload', function () { | |||
if ( !$textbox ) return; | |||
if ( $textbox.val() !== lastSavedContent ) saveDraft( true ); | |||
} ); | |||
$( document ).on( 'visibilitychange', function () { | |||
if ( document.visibilityState === 'hidden' && $textbox && $textbox.val() !== lastSavedContent ) { | |||
saveDraft( true ); | |||
} | |||
} ); | |||
$( window ).on( 'pagehide', function () { | |||
if ( $textbox && $textbox.val() !== lastSavedContent ) { | |||
saveDraft( true ); | saveDraft( true ); | ||
} | } | ||
} ); | |||
var submitted = false; | |||
$( document ).on( 'submit', 'form', function () { | |||
submitted = true; | |||
} ); | |||
$( window ).on( 'pagehide', function () { | |||
if ( submitted ) storage.remove( storageKey ); | |||
if ( | } ); | ||
} | } | ||
} | |||
// ---- | // ---- Ждём textarea ---- | ||
function waitForTextbox( cb ) { | |||
var tries = 0; | |||
var timer = setInterval( function () { | |||
var $tb = $( '#wpTextbox1' ); | |||
if ( | if ( $tb.length ) { | ||
clearInterval( timer ); | |||
cb( $tb ); | |||
} else if ( ++tries > 100 ) { | |||
clearInterval( timer ); | |||
} | } | ||
} | }, 100 ); | ||
} | } | ||
// ---- Старт ---- | // ---- Старт ---- | ||
if ( document.readyState === 'loading' ) { | |||
document.addEventListener( 'DOMContentLoaded', boot ); | |||
} else { | |||
boot(); | |||
} | |||
function boot() { | |||
waitForTextbox( function ( $tb ) { | |||
$textbox = $tb; | |||
lastSavedContent = $textbox.val() || ''; | |||
buildIndicator(); | |||
initDraft(); | |||
bindEvents(); | |||
} ); | |||
} | |||
} )(); | } )(); | ||