MediaWiki:Common.js
Версия от 01:47, 9 июня 2021; Ozzy (обсуждение | вклад)
Замечание. Возможно, после сохранения вам придётся очистить кэш своего браузера, чтобы увидеть изменения.
- Firefox / Safari: Удерживая клавишу Shift, нажмите на панели инструментов Обновить либо нажмите Ctrl-F5 или Ctrl-R (⌘-R на Mac)
- Google Chrome: Нажмите Ctrl-Shift-R (⌘-Shift-R на Mac)
- Internet Explorer: Удерживая Ctrl, нажмите Обновить либо нажмите Ctrl-F5
- Opera: Перейдите в Menu → Настройки (Opera → Настройки на Mac), а затем Безопасность → Очистить историю посещений → Кэшированные изображения и файлы
* Код MediaWiki:Common.js безусловно загружается всем пользователям на всех страницах. * Во избежание отправки лишних запросов по возможности не используйте здесь mw.loader.using * с модулями, которые не загружаются по умолчанию (см. * [[w:Обсуждение MediaWiki:Common.js#Список модулей, загружаемых по умолчанию]]). В таком случае * лучше создать скрытый гаджет, загружаемый по умолчанию, и добавить ему нужные модули в качестве * зависимостей. */ /** * Локальная функция загрузки скриптов с поддержкой указания проекта */ var importScript_ = importScript; importScript = function ( page, proj ) { if ( !proj ) { importScript_( page ); } else { if ( proj.indexOf( '.' ) === -1 ) { proj += '.wikipedia.org'; } mw.loader.using( 'mediawiki.util' ).done( function () { mw.loader.load( '//' + proj + '/w/index.php?title=' + mw.util.wikiUrlencode( page ) + '&action=raw&ctype=text/javascript' ); } ); } }; /** * Часто те или иные манипуляции со страницей нужно выполнить как можно раньше, но нет гарантии, что * к моменту выполнения кода нужный участок DOM готов, а событие полной загрузки страницы происходит * слишком поздно. В этой функции проверяется наличие элемента $testElement и в случае успеха * функция-колбэк выполняется, иначе же её выполнение поручается другой функции. Если элемент * в $testElement имеет содержимое, правильнее указать следующий за ним элемент, чтобы быть * уверенным, что он загрузился до конца. Имейте в виду, что разные скины часто используют разные * названия классов и идентификаторов. */ function runAsEarlyAsPossible( callback, $testElement, func ) { func = func || $; $testElement = $testElement || $( '#footer' ); if ( $testElement.length ) { callback(); } else { func( callback ); } } /** * Строки. Иноязычный интерфейс предположительно включают весьма редко, поэтому раздувать этот * список не стоит. При необходимости добавить много сообщений во много языков можно использовать * механизм системных сообщений (= страниц в пространстве MediaWiki, у которых могут быть суффиксы * типа /en). См., как их получение реализовано в MediaWiki:Gadget-sidebarRelated.js. */ var expandCaption, collapseCaption, zeroSectionTip; if ( mw.config.get( 'wgUserLanguage' ) === 'en' ) { expandCaption = 'show'; collapseCaption = 'hide'; zeroSectionTip = 'Edit lead section'; } else { expandCaption = 'показать'; collapseCaption = 'скрыть'; zeroSectionTip = 'Править преамбулу'; } /** * Выполнение скриптов из пространства MediaWiki, указанных в URL * См. также https://www.mediawiki.org/wiki/Snippets/Load_JS_and_CSS_by_URL */ var withJS = location.href.match( /[&?]withjs=((mediawiki:)?([^&#]+))/i ); if ( withJS ) { importScript_( 'MediaWiki:' + withJS[3] ); } /** * Код, который нужно выполнить как можно раньше. Он выполняется, если загружен подвал страницы, * иначе же ждёт наступления события wikipage.content (см. выше определение runAsEarlyAsPossible * и ниже про wikipage.content). */ runAsEarlyAsPossible( function () { /** * {{выполнить скрипт}} */ var $execJS = $( '.executeJS' ); if ( $execJS.length ) { $execJS.each( function () { $.each( $( this ).data( 'scriptnames' ).split( ' ' ), function ( i, sc ) { sc = $.trim( sc.replace( /[^\w ]/g, '' ) ); if ( sc ) { importScript( 'MediaWiki:Script/' + sc + '.js' ); } } ); } ); } /** * Чтобы ссылки на очистку кэша не требовали подтверждения (они должны быть помещены в тег с классом * purgelink и именем страницы в параметре data-pagename, например как в шаблоне {{очистить кэш}}) */ $( '.purgelink a' ).click( function ( e ) { mw.loader.using( [ 'mediawiki.api', 'mediawiki.util' ] ).done( function () { var pageName = $( this ).parent( '.purgelink' ).data( 'pagename' ) || mw.config.get( 'wgPageName' ); new mw.Api().post( { action: 'purge', titles: pageName } ).then( function () { var url = mw.util.getUrl( pageName ); if ( e.ctrlKey ) { if ( !window.open( url ) ) { location.assign( url ); } } else { location.assign( url ); } }, function () { mw.notify( 'Не удалось очистить кэш.', { type: 'error' } ); } ); e.preventDefault(); } ); } ); }, $( '#footer' ), mw.hook( 'wikipage.content' ).add ); /** * {{TOC hidden}} */ function TOChidden() { $( '.tochidden-wrapper > #toc' ).addClass( 'tochidden' ); $( '.tochidden-wrapper .togglelink' ).text( mw.msg( 'showtoc' ) ); $( '.tochidden-wrapper > #toc > ul' ).css( 'display', 'none' ); } runAsEarlyAsPossible( function () { if ( $( '.tochidden-wrapper' ).length ) { mw.loader.using( [ 'mediawiki.cookie' ], function () { if ( mw.cookie.get( 'hidetoc' ) === null ) { $.when( mw.loader.using( [ 'mediawiki.toc' ] ), $.ready ).then( TOChidden ); } } ); } }, $( '#toc' ), mw.hook( 'wikipage.content' ).add ); /** * Код, выполняемый по событию wikipage.content (его обработчики выполняются раньше колбэков для $, * хотя в глубине это одно и то же событие, просто колбэк, инициирующий wikipage.content, становится * в очередь раньше). Так как wikipage.content инициируется после обновления страницы в результате * Ajax-запросов (например, гаджетом быстрого предпросмотра), не добавляйте сюда коды, которые * должны гарантированно выполниться один раз на странице. */ mw.hook( 'wikipage.content' ).add( function () { /** * Отключение обтекания раздела примечаний, если в нём есть колонки */ $( '.references-small.columns' ).each( function () { $( this ).after( '<div class="temporaryDiv"></div>' ).next().prevUntil( 'h1, h2, h3, h4, h5, h6' ) .last().prev().css( 'clear', 'both' ); } ); // Этот элемент нужен на случай, если примечания — последний элемент (потребность в next() // возникает из-за невключительности prevUntil() jQuery) $( '.temporaryDiv' ).remove(); /** * Imagemap Highlight */ // На странице есть как минимум один элемент .imageMapHighlighter, а браузер поддерживает <canvas> if ( $( '.imageMapHighlighter' ).length && $( '<canvas>' )[ 0 ].getContext ) { importScript( 'MediaWiki:Imagemap-Highlight.js' ); } /** * Авторазбиение списков на колонки. Будет работать только для однострочных списков. 35em * (из Mediawiki:Common.css) является предварительным числом, а фактическое будет посчитано исходя * из ширины элементов. Должно использоваться только для UL внутри DIV. Пример использования — * шаблон {{Wikidata/SisterCities}}. */ $("div.autocolumns").each(function(d, div) { var parentWidth = $(div).parent()[0].offsetWidth; if (!parentWidth) return; var maxWidth = 0; var elements = 0; $(div).find("ul>li").each(function(l, li) { elements++; var jLi = $(li); if (jLi.children().length != jLi.contents().length) jLi.wrapInner(document.createElement("span")); var liWidth = 0; jLi.children().each(function(c, child) { liWidth += child.offsetWidth; }); if (liWidth > maxWidth) maxWidth = liWidth; }); if ( maxWidth == 0 ) return; // UL/LI bullet width + padding maxWidth += 22.5 * 2; var maxColumns = "" + Math.ceil( elements / 5 ); $(div).css({"-moz-columns": maxWidth + "px " + maxColumns, "columns" : maxWidth + "px " + maxColumns}); }); }); /** * Кнопки описания правок для визуального редактора */ mw.hook( 've.activationComplete' ).add( function () { mw.loader.load( 'ext.gadget.summaryButtons' ); } );