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 ) );