Wikisource:Linee guida per i gadget

Questa pagina presenta una serie di linee guida che si suggerisce di seguire nello sviluppo dei gadget, allo scopo di uniformare il più possibile l'aspetto grafico ed il funzionamento dei diversi gadget.

Stili

Esiste un foglio di stile comune: MediaWiki:Gadget-common.css, che è esposto da un gadget "nascosto" chiamato common-style.

Per includerlo correttamente in MediaWiki:Gadgets-definition si fa così:

* nome_del_gadget[ResourceLoader|peers=common-style|dependencies=ext.gadget.common-style]|nome_del_gadget.js|nome_del_gadget.css

Popup

I gadget che presentano dei popup dovrebbero includere il common.css e poi usare questa struttura:

<div class="box">
   <div class="box-title">Titolo del popup<span class="icon-close"></span></div>
   <div class="box-main">contenuto...</div>
</div>

Si consiglia di rendere trascinabile il box, così:

$('#nome_del_box').draggable({
	create: function( event, ui ) {
		$(this).css({
			right: "auto",
			top: $(this).position().top,
			left: $(this).position().left
		});
	}
});
// escludi il corpo del box dal trascinamento
$('#nome_del_box').draggable('option', 'cancel', '.box-main');

L'icona di chiusura del box va attivata così:

$('#nome_del_box .icon-close').click(function() {
	$('#nome_del_box').remove();
});