Questa pagina spiegherà i modi consigliati per aggiungere CSS e JavaScript aggiuntivi alla tua community.
ImportJS
MediaWiki:ImportJS fornisce un'interfaccia per aggiungere pagine che contengono script su una community - sia locali che dalla Dev Wiki.
La wiki non ha bisogno di avere il JS personalizzato abilitato affinché ImportJS funzioni.
Uso
MediaWiki:ImportJS fornisce una semplice pagina di testo in cui specificare i nomi della pagine di JavaScript. Codici locali devono essere nel namespace MediaWiki. Anche gli script importati dalla Dev Wiki devono essere nel namespace MediaWiki. Quando si dichiarano le pagine dei codici da importare, il namespace MediaWiki può essere omesso. Esempio:
// pagina JS locale Cat.js // script della Dev Wiki dev:UploadMultipleFiles.js
Revisione JavaScript
La funzione ImportJS scavalca la necessità del processo di revisione del JavaScript. Ciò consente l'aggiunta o la rimozione immediata di importazioni di JavaScript su una community! |
La funzionalità ImportJS è simile al metodo esistente di importArticles
, che può importare diversi articoli da community locali o esterne, compattarle in un'unica richiesta alla rete e minimizzarle. Sia importArticles
sia ImportJS riducono la dimensione del file e il traffico web, migliorando di conseguenza le community con un grande numero di fil aggiuntivi da caricare velocemente.
Ordine di caricamento
Quando si usa ImportJS, le pagine contenuto saranno caricate per ultime. L'ordine completo di caricamento è il seguente:
- Common.js
- Fandomdesktop.js
- Script importati attraverso Common.js
- Script importati attraverso Fandomdesktop.js
- ImportJS
Import CSS
Metodo @import
Usando @import
, gli stili possono essere importati da qualunque pagina CSS su una wiki o altri siti (che finisca con .css nell'URL e contenga cambiamenti per la skin nel file). La sintassi è la seguente:
@import "percorso_file_da_importare.css"
Seguendo l'esempio precedente, per importare MediaWiki:Local.css su MediaWiki:Common.css, aggiungi questo in cima a MediaWiki:Common.css come primo comando (deve essere prima di ogni altra regola):
@import "/load.php?articles=MediaWiki:Local.css&only=styles&mode=articles";
Un modo alternativo, che potrebbe rendere più semplice individuare i file caricati nella scheda "Network" dello strumento "Web Developer" del proprio browser, è utilizzare:
@import url("/MediaWiki:Local.css?ctype=text/css&action=raw");
Puoi leggere di più su questo metodo qui.
importArticles
In virtù del metodo discusso precedentemente, qui discuteremo l'uso di importArticles
solamente per quanto riguarda il CSS. Per le importazioni di codici JS, leggere questa pagina.
importArticles
può sempre essere usato per importare fogli CSS. Tuttavia saranno soggetti al processo di revisione in quanto sono importati tramite JavaScript. In aggiunta, caricare il CSS in questo modo crea un effetto mentre il CSS viene applicato dopo che la pagina viene mostrata inizialmente. Per risultati migliori, usate il metodo @import
Esempio
Importare un file CSS locale attraverso importArticles:
importArticles({
type: "style",
article: "MediaWiki:Local.css"
});
Vedere anche
- Aiuto:Includere CSS e JS aggiuntivi/avanzato.
- Aiuto:Personalizzare CSS e JS.
- Aiuto:CSS e JS avanzati
- Aiuto:Pagine CSS e JS
Ulteriore aiuto e feedback
- Naviga e cerca altre pagine di aiuto su Contenuti.
- Esplora la Wiki della Community per ulteriori fonti di aiuto o supporto.
- Leggi come contattare Fandom per problemi o segnalare errori.