MediaWiki:Gadget-rsw-util.js: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
Tag: Manual revert
No edit summary
Tag: Reverted
Line 1:
"use strict";
 
(function ($, mw, rs) {
'use strict';
 
function createOOUIWindowManager() {
'use strict';
if (window.OOUIWindowManager == undefined) {
window.OOUIWindowManager = new OO.ui.WindowManager();
function createOOUIWindowManager() {
if $('body').append(window.OOUIWindowManager == undefined.$element) {;
}
window.OOUIWindowManager = new OO.ui.WindowManager();
$( 'body' ).append(return window.OOUIWindowManager.$element );
}
return window.OOUIWindowManager;
}
 
/**
* Reusable functions
*
* These are available under the `rswiki` global variable.
* @example `rswiki.addCommas`
* The alias `rs` is also available in place of `rswiki`.
*/
var util = {
/**
* Formats a number string with commas.
* Reusable functions
*
* @todo fully replace this with Number.protoype.toLocaleString
* > 123456.78.toLocaleString('en')
*
* @example 123456.78 -> 123,456.78
*
* @param num {Number|String} The number to format.
* These are available under the `rswiki` global variable.
* @return {String} The formated number.
* @example `rswiki.addCommas`
* The alias `rs` is also available in place of `rswiki`.
*/
addCommas: function addCommas(num) {
var util = {
if (typeof /**num === 'number') {
return num.toLocaleString('en');
* Formats a number string with commas.
*}
* @todo fully replace this with Number.protoype.toLocaleString
* > 123456.78.toLocaleString('en')
*
* @example 123456.78 -> 123,456.78
*
* @param num {Number|String} The number to format.
* @return {String} The formated number.
*/
addCommas: function (num) {
if (typeof num === 'number') {
return num.toLocaleString('en');
}
 
// @todo chuck this into parseFloat first and then to toLocaleString?
num += '';
var x = num.split('.'),
x1 = x[0],
x2 = x.length > 1 ? '.' + x[1] : '',
rgx = /(\d+)(\d{3})/;
while (rgx.test(x1)) {
x1 = x1.replace(rgx, '$1,$2');
}
return x1 + x2;
},
/**
* Extracts parameter-argument pairs from templates.
*
* @todo Fix for multiple templates
*
* @param tpl {String} Template to extract data from.
* @param text {String} Text to look for template in.
* @return {Object} Object containing parameter-argument pairs
*/
parseTemplate: function parseTemplate(tpl, text) {
var rgx = new RegExp('\\{\\{(template:)?' + tpl.replace(/[ _]/g, '[ _]') + '\\s*(\\||\\}\\})', 'i'),
exec = rgx.exec(text),
// splits template into |arg=param or |param
paramRgx = /\|(.*?(\{\{.+?\}\})?)(?=\s*\||$)/g,
args = {},
params,
i,
j;
 
// happens if the template is varnot xfound =in num.split('.'),the text
if (exec === null) x1 = x[0],{
return x2 = x.length > 1 ?false;
}
'.' + x[1] :
text = text.substring(exec.index + 2);
'',
rgx = /(\d+)(\d{3})/;
 
// used to account for nested while (rgx.test(x1)) {templates
x1j = x1.replace(rgx, '$1,$2')0;
}
 
// this purposefully doesn't use regex
return x1 + x2;
// as it became very difficult to make it work properly
},
for (i = 0; i < text.length; i += 1) {
if (text[i] === '{') {
j += 1;
} else if (text[i] === '}') {
if (j > 0) {
j -= 1;
} else {
break;
}
}
}
 
// cut off where the template ends
/**
text = text.substring(0, i);
* Extracts parameter-argument pairs from templates.
// remove template name as we're not interested in it past this point
*
text = text.substring(text.indexOf('|')).trim();
* @todo Fix for multiple templates
// separate params and args into an array
*
params = text.match(paramRgx);
* @param tpl {String} Template to extract data from.
* @param text {String} Text to look for template in.
* @return {Object} Object containing parameter-argument pairs
*/
parseTemplate: function (tpl, text) {
var rgx = new RegExp(
'\\{\\{(template:)?' + tpl.replace(/[ _]/g, '[ _]') + '\\s*(\\||\\}\\})',
'i'
),
exec = rgx.exec(text),
// splits template into |arg=param or |param
paramRgx = /\|(.*?(\{\{.+?\}\})?)(?=\s*\||$)/g,
args = {},
params,
i,
j;
 
// handle no params/args
// happens if the template is not found in the text
if (execparams =!== null) {
// used as an index for unnamed return false;params
i = }1;
params.forEach(function (el) {
var str = el.trim().substring(1),
eq = str.indexOf('='),
tpl = str.indexOf('{{'),
param,
val;
 
// checks if the equals is after opening a template
text = text.substring(exec.index + 2);
// to catch unnamed args that have templates with named args as params
 
if (eq //> used-1 to&& account(tpl for=== nested-1 templates|| eq < tpl)) {
jparam = str.substring(0, eq).trim().toLowerCase();
val = str.substring(eq + 1).trim();
 
} else // this purposefully doesn't use regex{
param = i;
// as it became very difficult to make it work properly
for (ival = 0; i < textstr.lengthtrim(); i += 1) {
if (text[i] +=== '{') {1;
j += 1;}
} else if (textargs[iparam] === '}') {val;
if (j > 0}) {;
}
j -= 1;
return } else {args;
},
break;
/**
}
* Alternate version of `parseTemplate` for parsing exchange module data.
}
*
* @notes Only works for key-value pairs
*
* @param text {String} Text to parse.
* @return {Object} Object containing parameter-argument pairs.
*/
parseExchangeModule: function parseExchangeModule(text) {
// strip down to just key-value pairs
var str = text.replace(/return\s*\{/, '').replace(/\}\s*$/, '').trim(),
rgx = /\s*(.*?\s*=\s*(?:\{[\s\S]*?\}|.*?))(?=,?\n|$)/g,
args = {},
params = str.match(rgx);
if (params !== null) {
params.forEach(function (elem) {
var str = elem.trim(),
eq = str.indexOf('='),
param = str.substring(0, eq).trim().toLowerCase(),
val = str.substring(eq + 1).trim();
args[param] = val;
});
}
return args;
},
/**
* Helper for making cross domain requests to RuneScape's APIs.
* If the APIs ever enable CORS, we can ditch this and do the lookup directly.
*
* @param url {string} The URL to look up
* @param via {string} One of 'anyorigin', 'whateverorigin' or 'crossorigin'. Defaults to 'anyorigin'.
*
* @return {string} The URLto use to make the API request.
*/
crossDomain: function crossDomain(url, via) {
switch (via) {
case 'crossorigin':
url = 'http://crossorigin.me/' + url;
break;
case 'whateverorigin':
url = 'http://whateverorigin.org/get?url=' + encodeURIComponent(url) + '&callback=?';
break;
case 'anyorigin':
default:
url = 'http://anyorigin.com/go/?url=' + encodeURIComponent(url) + '&callback=?';
break;
}
return url;
},
/**
* Returns the OOUI window manager as a Promise. Will load OOUI (core and windows) and create the manager, if necessary.
*
* @return {jQuery.Deferred} A jQuery Promise where window.OOUIWindowManager is will be defined
* Chaining a .then will pass OOUIWindowManager to the function argument
*/
withOOUIWindowManager: function withOOUIWindowManager() {
return mw.loader.using(['oojs-ui-core', 'oojs-ui-windows']).then(createOOUIWindowManager);
},
/**
* Helper for creating and initializing a new OOUI Dialog object
* After init, the window is added to the global Window Manager.
*
* Will automatically load OOUI (core and windows) and create the window manager, if necessary. window.OOUIWindowManager will be defined within this.
*
* @author JaydenKieran
*
* @param name {string} The symbolic name of the window
* @param title {string} The title of the window
* @param winconfig {object} Object containing params for the OO.ui.Dialog obj
* @param init {function} Function to be called to initialise the object
* @param openNow {boolean} Whether the window should be opened instantly
* @param autoClose {boolean} Autoclose when the user clicks outside of the modal
*
* @return {jquery.Deferred} The jQuery Promise returned by mw.loader.using
* Chaining a .then will pass the created {OO.ui.Dialog} object as the function argument
*/
createOOUIWindow: function createOOUIWindow(name, title, winconfig, init, openNow, autoClose) {
return mw.loader.using(['oojs-ui-core', 'oojs-ui-windows']).then(function () {
createOOUIWindowManager();
winconfig = winconfig || {};
function myModal(config) {
myModal["super"].call(this, config);
}
OO.inheritClass(myModal, OO.ui.Dialog);
myModal["static"].name = name;
myModal["static"].title = title;
myModal.prototype.initialize = function () {
myModal["super"].prototype.initialize.call(this);
init(this);
};
var modal = new myModal(winconfig);
console.debug('Adding ' + myModal["static"].name + ' to WindowManager');
window.OOUIWindowManager.addWindows([modal]);
if (openNow) {
window.OOUIWindowManager.openWindow(name);
}
if (autoClose) {
$(document).on('click', function (e) {
if (modal && modal.isVisible() && e.target.classList.contains('oo-ui-window-active')) {
modal.close();
}
;
 
// cut off where the template ends});
}
text = text.substring(0, i);
return modal;
// remove template name as we're not interested in it past this point
});
text = text.substring(text.indexOf('|')).trim();
},
// separate params and args into an array
/**
params = text.match(paramRgx);
* Helper for checking if the user's browser supports desktop notifications
 
* @author JaydenKieran
// handle no params/args
*/
if (params !== null) {
canSendBrowserNotifs: function canSendBrowserNotifs() {
// used as an index for unnamed params
if (!("Notification" in window)) {
i = 1;
console.warn("This browser does not support desktop notifications");
 
return false;
params.forEach(function (el) {
} else {
var str = el.trim().substring(1),
return true;
eq = str.indexOf('='),
}
tpl = str.indexOf('{{'),
},
param,
/**
val;
* Send a desktop/browser notification to a user, requires the page to be open
 
* @author JaydenKieran
// checks if the equals is after opening a template
*
// to catch unnamed args that have templates with named args as params
* @param https://developer.mozilla.org/en-US/docs/Web/API/Notification/Notification
if (eq > -1 && (tpl === -1 || eq < tpl)) {
*
param = str.substring(0, eq).trim().toLowerCase();
* @return Notification object or null
val = str.substring(eq + 1).trim();
*/
} else {
sendBrowserNotif: function sendBrowserNotif(title, opts) {
param = i;
if val(rs.canSendBrowserNotifs == str.trim(false); {
return i += 1null;
}
Notification.requestPermission().then(function (result) {
 
if (result === "granted") {
args[param] = val;
console.debug('Firing desktop }notification');
var notif }= new Notification(title, opts);
notif.onclick = function (e) {
 
return argswindow.focus();
},;
return notif;
 
/**} else {
return null;
* Alternate version of `parseTemplate` for parsing exchange module data.
*}
});
* @notes Only works for key-value pairs
*},
/**
* @param text {String} Text to parse.
* Check if the browser has support for localStorage
* @return {Object} Object containing parameter-argument pairs.
* @author */JaydenKieran
*
parseExchangeModule: function (text) {
* @return boolean
 
**/
// strip down to just key-value pairs
hasLocalStorage: function hasLocalStorage() {
var str = text
try {
.replace(/return\s*\{/, '')
localStorage.replacesetItem(/\}\s*$/'test', 'test');
localStorage.trimremoveItem('test'),;
return true;
rgx = /\s*(.*?\s*=\s*(?:\{[\s\S]*?\}|.*?))(?=,?\n|$)/g,
} catch args =(e) {},
return params = str.match(rgx)false;
}
 
},
if (params !== null) {
/**
params.forEach(function (elem) {
* Check if user is using dark mode
var str = elem.trim(),
* @author JaydenKieran
eq = str.indexOf('='),
*
param = str.substring(0, eq).trim().toLowerCase(),
* @return boolean
val = str.substring(eq + 1).trim();
**/
 
isUsingDarkmode: function isUsingDarkmode() {
args[param] = val;
if (typeof $.cookie('darkmode') === 'undefined') {
});
return }false;
} else {
 
return $.cookie('darkmode') === return args'true';
},
},
 
/**
* Gets a query string parameter from given URL or current href
* Helper for making cross domain requests to RuneScape's APIs.
* @author JaydenKieran
* If the APIs ever enable CORS, we can ditch this and do the lookup directly.
* *
* @paramreturn url {string} The URL to lookor upnull
**/
* @param via {string} One of 'anyorigin', 'whateverorigin' or 'crossorigin'. Defaults to 'anyorigin'.
qsp: function qsp(name, url) *{
if (!url) url = window.location.href;
* @return {string} The URLto use to make the API request.
name = name.replace(/[\[\]]/g, '\\$&');
*/
var regex = new RegExp('[?&]' + name + '(=([^&#]*)|&|#|$)'),
crossDomain: function (url, via) {
results = switch regex.exec(viaurl) {;
if (!results) return null;
case 'crossorigin':
if (!results[2]) return '';
url = 'http://crossorigin.me/' + url;
return decodeURIComponent(results[2].replace(/\+/g, ' '));
break;
},
 
/**
case 'whateverorigin':
* Get the URL for a file on the wiki, aganst the endpoint that is actually cached and fast.
url = 'http://whateverorigin.org/get?url=' + encodeURIComponent( url ) + '&callback=?';
* Should probably not be used for images we expect to break;change frequently.
* @author cookmeplox
 
*
case 'anyorigin':
* @return default:string
**/
url = 'http://anyorigin.com/go/?url=' + encodeURIComponent( url ) + '&callback=?';
getFileURLCached: function getFileURLCached(filename) {
break;
var base = }window.location.origin;
filename = filename.replace(/ /g, "_");
 
filename = filename.replace(/\(/g, '%28').replace(/\)/g, '%29');
return url;
var cb },= '48781';
return base + '/images/' + filename + '?' + cb;
/**
},
* Returns the OOUI window manager as a Promise. Will load OOUI (core and windows) and create the manager, if necessary.
isUsingStickyHeader: function isUsingStickyHeader() {
*
return $('body').hasClass('wgl-stickyheader');
* @return {jQuery.Deferred} A jQuery Promise where window.OOUIWindowManager is will be defined
* Chaining a .then will pass OOUIWindowManager to the function argument
*/
withOOUIWindowManager: function() {
return mw.loader.using(['oojs-ui-core','oojs-ui-windows']).then(createOOUIWindowManager);
},
/**
* Helper for creating and initializing a new OOUI Dialog object
* After init, the window is added to the global Window Manager.
*
* Will automatically load OOUI (core and windows) and create the window manager, if necessary. window.OOUIWindowManager will be defined within this.
*
* @author JaydenKieran
*
* @param name {string} The symbolic name of the window
* @param title {string} The title of the window
* @param winconfig {object} Object containing params for the OO.ui.Dialog obj
* @param init {function} Function to be called to initialise the object
* @param openNow {boolean} Whether the window should be opened instantly
* @param autoClose {boolean} Autoclose when the user clicks outside of the modal
*
* @return {jquery.Deferred} The jQuery Promise returned by mw.loader.using
* Chaining a .then will pass the created {OO.ui.Dialog} object as the function argument
*/
createOOUIWindow: function(name, title, winconfig, init, openNow, autoClose) {
return mw.loader.using(['oojs-ui-core','oojs-ui-windows']).then(function(){
createOOUIWindowManager();
winconfig = winconfig || {};
function myModal( config ) {
myModal.super.call( this, config );
}
OO.inheritClass( myModal, OO.ui.Dialog );
myModal.static.name = name;
myModal.static.title = title;
myModal.prototype.initialize = function () {
myModal.super.prototype.initialize.call( this );
init(this);
}
var modal = new myModal(winconfig);
console.debug('Adding ' + myModal.static.name + ' to WindowManager');
window.OOUIWindowManager.addWindows( [ modal ] );
if (openNow) {
window.OOUIWindowManager.openWindow(name);
}
if (autoClose) {
$(document).on('click', function (e) {
if (modal && modal.isVisible() && e.target.classList.contains('oo-ui-window-active')) {
modal.close();
};
});
}
return modal;
});
},
/**
* Helper for checking if the user's browser supports desktop notifications
* @author JaydenKieran
*/
canSendBrowserNotifs: function () {
if (!("Notification" in window)) {
console.warn("This browser does not support desktop notifications");
return false;
} else {
return true;
}
},
/**
* Send a desktop/browser notification to a user, requires the page to be open
* @author JaydenKieran
*
* @param https://developer.mozilla.org/en-US/docs/Web/API/Notification/Notification
*
* @return Notification object or null
*/
sendBrowserNotif: function (title, opts) {
if (rs.canSendBrowserNotifs == false) {
return null;
}
Notification.requestPermission().then(function(result) {
if (result === "granted") {
console.debug('Firing desktop notification');
var notif = new Notification(title, opts);
notif.onclick = function(e) {
window.focus();
}
return notif;
} else {
return null;
}
});
},
/**
* Check if the browser has support for localStorage
* @author JaydenKieran
*
* @return boolean
**/
hasLocalStorage: function() {
try {
localStorage.setItem('test', 'test')
localStorage.removeItem('test')
return true
} catch (e) {
return false
}
},
/**
* Check if user is using dark mode
* @author JaydenKieran
*
* @return boolean
**/
isUsingDarkmode: function() {
if (typeof $.cookie('darkmode') === 'undefined') {
return false
} else {
return $.cookie('darkmode') === 'true'
}
},
/**
* Gets a query string parameter from given URL or current href
* @author JaydenKieran
*
* @return string or null
**/
qsp: function(name, url) {
if (!url) url = window.location.href;
name = name.replace(/[\[\]]/g, '\\$&');
var regex = new RegExp('[?&]' + name + '(=([^&#]*)|&|#|$)'),
results = regex.exec(url);
if (!results) return null;
if (!results[2]) return '';
return decodeURIComponent(results[2].replace(/\+/g, ' '));
},
 
/**
* Get the URL for a file on the wiki, aganst the endpoint that is actually cached and fast.
* Should probably not be used for images we expect to change frequently.
* @author cookmeplox
*
* @return string
**/
getFileURLCached: function(filename) {
var base = window.location.origin;
filename = filename.replace(/ /g,"_");
filename = filename.replace(/\(/g, '%28').replace(/\)/g, '%29');
var cb = '48781';
return base + '/images/' + filename + '?' + cb;
},
isUsingStickyHeader: function() {
return ($('body').hasClass('wgl-stickyheader'))
}
};
 
function init() {
$.extend(rs, util, {});
// add rs as a global alias
window.rs = rs;
}
};
 
function init(); {
$.extend(rs, util, {});
 
// add rs as a global alias
}(this.jQuery, this.mediaWiki, this.rswiki = this.rswiki || {}));
window.rs = rs;
}
init();
})((void 0).jQuery, (void 0).mediaWiki, (void 0).rswiki = (void 0).rswiki || {});

Navigation menu