resources/src/mediawiki.legacy/wikibits.js

   1 /**
   2  * MediaWiki legacy wikibits
   3  */
   4 ( function ( mw, $ ) {
   5         var msg,
   6                 win = window,
   7                 ua = navigator.userAgent.toLowerCase(),
   8                 onloadFuncts = [];
   9
  10 /**
  11  * User-agent sniffing.
  12  *
  13  * @deprecated since 1.17 Use jquery.client instead
  14  */
  15
  16 msg = 'Use feature detection or module jquery.client instead.';
  17
  18 mw.log.deprecate( win, 'clientPC', ua, msg );
  19
  20 // Ignored dummy values
  21 mw.log.deprecate( win, 'is_gecko', false, msg );
  22 mw.log.deprecate( win, 'is_chrome_mac', false, msg );
  23 mw.log.deprecate( win, 'is_chrome', false, msg );
  24 mw.log.deprecate( win, 'webkit_version', false, msg );
  25 mw.log.deprecate( win, 'is_safari_win', false, msg );
  26 mw.log.deprecate( win, 'is_safari', false, msg );
  27 mw.log.deprecate( win, 'webkit_match', false, msg );
  28 mw.log.deprecate( win, 'is_ff2', false, msg );
  29 mw.log.deprecate( win, 'ff2_bugs', false, msg );
  30 mw.log.deprecate( win, 'is_ff2_win', false, msg );
  31 mw.log.deprecate( win, 'is_ff2_x11', false, msg );
  32 mw.log.deprecate( win, 'opera95_bugs', false, msg );
  33 mw.log.deprecate( win, 'opera7_bugs', false, msg );
  34 mw.log.deprecate( win, 'opera6_bugs', false, msg );
  35 mw.log.deprecate( win, 'is_opera_95', false, msg );
  36 mw.log.deprecate( win, 'is_opera_preseven', false, msg );
  37 mw.log.deprecate( win, 'is_opera', false, msg );
  38 mw.log.deprecate( win, 'ie6_bugs', false, msg );
  39
  40 /**
  41  * DOM utilities for handling of events, text nodes and selecting elements
  42  *
  43  * @deprecated since 1.17 Use jQuery instead
  44  */
  45 msg = 'Use jQuery instead.';
  46
  47 // Ignored dummy values
  48 mw.log.deprecate( win, 'doneOnloadHook', undefined, msg );
  49 mw.log.deprecate( win, 'onloadFuncts', [], msg );
  50 mw.log.deprecate( win, 'runOnloadHook', $.noop, msg );
  51 mw.log.deprecate( win, 'changeText', $.noop, msg );
  52 mw.log.deprecate( win, 'killEvt', $.noop, msg );
  53 mw.log.deprecate( win, 'addHandler', $.noop, msg );
  54 mw.log.deprecate( win, 'hookEvent', $.noop, msg );
  55 mw.log.deprecate( win, 'addClickHandler', $.noop, msg );
  56 mw.log.deprecate( win, 'removeHandler', $.noop, msg );
  57 mw.log.deprecate( win, 'getElementsByClassName', function () { return []; }, msg );
  58 mw.log.deprecate( win, 'getInnerText', function () { return ''; }, msg );
  59
  60 // Run a function after the window onload event is fired
  61 mw.log.deprecate( win, 'addOnloadHook', function ( hookFunct ) {
  62         if ( onloadFuncts ) {
  63                 onloadFuncts.push( hookFunct );
  64         } else {
  65                 // If func queue is gone the event has happened already,
  66                 // run immediately instead of queueing.
  67                 hookFunct();
  68         }
  69 }, msg );
  70
  71 $( win ).on( 'load', function () {
  72         var i, functs;
  73
  74         // Don't run twice
  75         if ( !onloadFuncts ) {
  76                 return;
  77         }
  78
  79         // Deference and clear onloadFuncts before running any
  80         // hooks to make sure we don't miss any addOnloadHook
  81         // calls.
  82         functs = onloadFuncts.slice();
  83         onloadFuncts = undefined;
  84
  85         // Execute the queued functions
  86         for ( i = 0; i < functs.length; i++ ) {
  87                 functs[i]();
  88         }
  89 } );
  90
  91 /**
  92  * Toggle checkboxes with shift selection
  93  *
  94  * @deprecated since 1.17 Use jquery.checkboxShiftClick instead
  95  */
  96 msg = 'Use jquery.checkboxShiftClick instead.';
  97 mw.log.deprecate( win, 'checkboxes', [], msg );
  98 mw.log.deprecate( win, 'lastCheckbox', null, msg );
  99 mw.log.deprecate( win, 'setupCheckboxShiftClick', $.noop, msg );
 100 mw.log.deprecate( win, 'addCheckboxClickHandlers', $.noop, msg );
 101 mw.log.deprecate( win, 'checkboxClickHandler', $.noop, msg );
 102
 103 /**
 104  * Add a button to the default editor toolbar
 105  *
 106  * @deprecated since 1.17 Use mw.toolbar instead
 107  */
 108 mw.log.deprecate( win, 'mwEditButtons', [], 'Use mw.toolbar instead.' );
 109 mw.log.deprecate( win, 'mwCustomEditButtons', [], 'Use mw.toolbar instead.' );
 110
 111 /**
 112  * Spinner creation, injection and removal
 113  *
 114  * @deprecated since 1.18 Use jquery.spinner instead
 115  */
 116 mw.log.deprecate( win, 'injectSpinner', $.noop, 'Use jquery.spinner instead.' );
 117 mw.log.deprecate( win, 'removeSpinner', $.noop, 'Use jquery.spinner instead.' );
 118
 119 /**
 120  * Escape utilities
 121  *
 122  * @deprecated since 1.18 Use mw.html instead
 123  */
 124 mw.log.deprecate( win, 'escapeQuotes', $.noop, 'Use mw.html instead.' );
 125 mw.log.deprecate( win, 'escapeQuotesHTML', $.noop, 'Use mw.html instead.' );
 126
 127 /**
 128  * Display a message to the user
 129  *
 130  * @deprecated since 1.17 Use mediawiki.notify instead
 131  * @param {string|HTMLElement} message To be put inside the message box
 132  */
 133 mw.log.deprecate( win, 'jsMsg', function ( message ) {
 134         if ( !arguments.length || message === '' || message === null ) {
 135                 return true;
 136         }
 137         if ( typeof message !== 'object' ) {
 138                 message = $.parseHTML( message );
 139         }
 140         mw.notify( message, { autoHide: true, tag: 'legacy' } );
 141         return true;
 142 }, 'Use mediawiki.notify instead.' );
 143
 144 /**
 145  * Misc. utilities
 146  *
 147  * @deprecated since 1.17 Use mediawiki.util or jquery.accessKeyLabel instead
 148  */
 149 msg = 'Use mediawiki.util instead.';
 150 mw.log.deprecate( win, 'addPortletLink', mw.util.addPortletLink, msg );
 151 mw.log.deprecate( win, 'appendCSS', mw.util.addCSS, msg );
 152 msg = 'Use jquery.accessKeyLabel instead.';
 153 mw.log.deprecate( win, 'tooltipAccessKeyPrefix', 'alt-', msg );
 154 mw.log.deprecate( win, 'tooltipAccessKeyRegexp', /\[(alt-)?(.)\]$/, msg );
 155 // mw.util.updateTooltipAccessKeys already generates a deprecation message.
 156 win.updateTooltipAccessKeys = function () {
 157         return mw.util.updateTooltipAccessKeys.apply( null, arguments );
 158 };
 159
 160 /**
 161  * Wikipage import methods
 162  */
 163
 164 // included-scripts tracker
 165 win.loadedScripts = {};
 166
 167 win.importScript = function ( page ) {
 168         var uri = mw.config.get( 'wgScript' ) + '?title=' +
 169                 mw.util.wikiUrlencode( page ) +
 170                 '&action=raw&ctype=text/javascript';
 171         return win.importScriptURI( uri );
 172 };
 173
 174 win.importScriptURI = function ( url ) {
 175         if ( win.loadedScripts[url] ) {
 176                 return null;
 177         }
 178         win.loadedScripts[url] = true;
 179         var s = document.createElement( 'script' );
 180         s.setAttribute( 'src', url );
 181         s.setAttribute( 'type', 'text/javascript' );
 182         document.getElementsByTagName( 'head' )[0].appendChild( s );
 183         return s;
 184 };
 185
 186 win.importStylesheet = function ( page ) {
 187         var uri = mw.config.get( 'wgScript' ) + '?title=' +
 188                 mw.util.wikiUrlencode( page ) +
 189                 '&action=raw&ctype=text/css';
 190         return win.importStylesheetURI( uri );
 191 };
 192
 193 win.importStylesheetURI = function ( url, media ) {
 194         var l = document.createElement( 'link' );
 195         l.rel = 'stylesheet';
 196         l.href = url;
 197         if ( media ) {
 198                 l.media = media;
 199         }
 200         document.getElementsByTagName( 'head' )[0].appendChild( l );
 201         return l;
 202 };
 203
 204 }( mediaWiki, jQuery ) );