« MediaWiki:Common.js » : différence entre les versions

Version du 2 janvier 2022 à 18:30

/* jshint scripturl:true, laxbreak:true, loopfunc:true */
/* global mw, $, importScript */
/**
 * N'importe quel JavaScript ici sera chargé pour n'importe quel utilisateur et pour chaque page accédée.
 *
 * ATTENTION : Avant de modifier cette page, veuillez tester vos changements avec votre propre
 * vector.js. Une erreur sur cette page peut faire bugger le site entier (et gêner l'ensemble des
 * visiteurs), même plusieurs heures après la modification !
 *
 * Prière de ranger les nouvelles fonctions dans les sections adaptées :
 * - Fonctions JavaScript
 * - Fonctions spécifiques pour MediaWiki
 * - Applications spécifiques à la fenêtre d'édition
 * - Applications qui peuvent être utilisées sur toute page
 * - Applications spécifiques à un espace de nom ou une page
 *
 * <nowiki> /!\ Ne pas retirer cette balise
 */


/**********************************************************************************************************/
/* Fonctions générales MediaWiki (pallient les limitations du logiciel)                                   */
/* Surveiller : https://git.wikimedia.org/history/mediawiki%2Fcore.git/HEAD/skins%2Fcommon%2Fwikibits.js  */
/**********************************************************************************************************/

/**
 * Projet JavaScript
 */
window.obtenir = function ( name ) {
	if ( mw.loader.getState( 'ext.gadget.' + name ) !== null ) {
		mw.loader.load( 'ext.gadget.' + name );
	} else {
		importScript( 'MediaWiki:Gadget-' + name + '.js' );
	}
};


// First wait for mediawiki.util to load, and the page to be ready.
$.when( mw.loader.using( 'mediawiki.util' ), $.ready ).then( function () { 

	// General usage pattern:
	// mw.util.addPortletLink( portletId, href, text /* Optional: , id, tooltip, accesskey, nextnode */ );

	// Example: Add a link to mediawiki.org to the Tools area, above the "Special pages" link.
	var newElement = mw.util.addPortletLink(
		'p-tb',
		'https://www.mediawiki.org/',
		'Link to mediawiki.org',
		't-mworg',
		'Go to www.mediawiki.org',
		'm',
		'#t-specialpages'
	);

	// The old way of passing a DOM-node also works
	mw.util.addPortletLink(
		'p-tb',
		'https://www.mediawiki.org/',
		'Link to mediawiki.org',
		't-mworg',
		'Go to www.mediawiki.org',	
		'm',
		document.getElementById( 't-specialpages' )
	);

} );