FANDOM


Il metodo JavaScript globale importArticles fornisce un modo comune per includere pagine di JavaScript o stili su una community.

Questa funzionalità è simile ai metodi di importScriptPage and importStylesheetPage, tuttavia a differenza di quelli importArticles può compattare diverse pagine in una sola, minimizzarle e servirle come una singola richiesta. Ciò riduce sia la dimensione che il traffico web, migliorando di conseguenza la velocità di caricamento per wiki con numerosi codici addizionali.

Uso

importArticles() si affida a definizioni modulari per caricare le pagine. I moduli sono essenzialmente oggetti JavaScript con specifici valori e proprietà. Le seguenti proprietà sono richieste per ogni modulo:

  • type - questa proprietà definisce il tipo di pagina che il modulo contiene. I tipi supportati sono:
  • articles - le pagine che vuoi importare. Vedere la sezione localizzare le pagine qui sotto per maggiori informazioni su cosa inserire qui.

Possono essere passati a importArticles() qualsiasi voglia numero di moduli, tuttavia tutte le pagine dentro ad un modulo devono essere dello stesso tipo.

Bulb Caching

I link generati da importArticles() (e gli altri metodi avanzati descritti qui sotto) sono memorizzati per un massimo di 10 minuti. Pertanto ogni volta che si compie una modifica si può assumere che dopo 10 minuti tutti gli utenti che visitano la wiki riceveranno la versione aggiornata del file JS e CSS se importArticles() è usato.

Localizzare le pagine

Una semplice sintassi viene usata per localizzare le pagine che si vogliono importare. È molto simile, e compatibile, con i link interwiki:

(Prefisso:<NomeWiki>:)<Pagina>

Tutto ciò dentro nelle parentesi tonde qui sopra è opzionale mentre tutto ciò nelle parentesi acute (chevron: <>) indica un input richiesto dell'utente. I doppi punti servono per dividere la stringa in diverse parti da processare. I prefissi ci indicano come vuoi cercare la pagina e sono in genere seguiti dal nome della wiki, tranne nel caso di pagine locali.

Pagine locali

Pagine locali, cioè nella stessa wiki su cui vengono importate, si possono individuare tramite il loro nome nella stessa maniere con cui le linkeresti. Non necessitano nessun prefisso o nome di wiki. Per esempio, se volessi importare la pagina MediaWiki:Common.js, la stringa seguente funzionerebbe in importArticles():

MediaWiki:Common.js

Pagine esterne

Pagine da wiki esterne, cioè diverse dalla wiki su cui vengono importate, si possono individuare allo stesso modo in cui le linkeresti. Tuttavia richiedono l'uso di un prefisso e del nome della wiki per determinare da quale wiki le stai importando e come indentificare tale wiki. FANDOM supporta l'individuazione di una wiki tramite l'URL. La ricerca in base all'URL sono eseguite con il prefisso u. Per esempio, se vuoi importare la pagina Highlight/code.css dalla Dev Wiki, la stringa seguente funzionerebbe in importArticles():

u:dev:Highlight/code.css

Questa sintassi funziona per wiki in qualsiasi lingua. Ad esempio se volessi importare la pagina MediaWiki:Common.js dalla versione francese della One Piece Wiki:

u:fr.onepiece:MediaWiki:Common.js

Uso avanzato

Dietro le quinte, importArticles() esegue tre compiti essenziali:

  1. Genera un URL propriamente formattato per l'uso con il ResourceLoader
  2. Controlla che i moduli usati nella funzione siano propriamente formattati
  3. Notifica l'utente in caso di errore.

Tuttavia l'uso di questo metodo non è strettamente necessario per sfruttare i benefici di combinare e compattare pagine multiple in una singola richiesta. Se preferisci, puoi generare l'URL manualmente e caricare le risorse con altri mezzi, come per esempio la dichiarazione @import per il CSS o jQuery.getScript per JavaScript.

Nonostante ci siano molti parametri che si possono includere nell'URL, i seguenti sono probabilmente i più utili:

Nome parametro Valore parametro
mode= articles - questo istruisce il ResourceLoader che sta per caricare delle pagine.
articles= la lista delle pagine da caricare. In caso di pagine multiple, devono essere separate da | (pipe)
only= Il tipo di pagine che si importano. Può essere o script o style
debug= true o false. Impostato su true disabilita la minimizzazione delle pagine. Non è normalmente necessario ma può tornare utile per individuare errori nel codice.

Alla fine dovresti ottenere un URL che assomiglia a qualcosa di questo tipo:

/load.php?mode=articles&articles=Uno.css|Due.css&only=styles

Che può essere usato in congiunzione con @import in questo modo:

@import url("/load.php?mode=articles&articles=Uno.css|Due.css&only=styles");

Se il CSS è salvato su un'altra wiki o un sito esterno a Wiki come Dropbox, l'URL deve contenere http:// o https:// come in questo esempio:

@import url("https://dl.dropboxusercontent.com/s/0p9ay0nqibx2wr7/manga_list.css");

In questo modo il file CSS salvato sul sito verrà usato ed importato sulla pagina su cui viene invocata la richiesta. Se il foglio di stile viene modificato fuori da Wiki e un comando di importazione è in uso, i cambiamenti avverranno immediatamente. Le pagine editate che usavano questo CSS dovranno aspettare un po' prima di vedere gli effetti del cambiamento. Dovrebbero avere i codici che personalizzano l'interfaccia in ordine prima che abbiano effetto se l'importazione del CSS avviene da una fonte esterna a FANDOM.


Esempi

Importazione di pagine scipt multiple, una localmente e una esternamente:

importArticles({
    type: "script",
    articles: [
        "MediaWiki:MyCustomJavaScript.js",
        "external:dev:MediaWiki:External_include.js"
    ]
});

Importazione di fogli CSS multipli, uno localmente e uno esternamente:

importArticles({
    type: "style",
    articles: [
        "MediaWiki:Common.css",
        "external:starwars:MediaWiki:External_include.css"
    ]
});

Importazione di moduli multipli in una singola invocazione:

importArticles({
    type: "script",
    articles: [
        "MediaWiki:MyCustomJavaScript.js",
        "external:dev:MediaWiki:External_include.js"
    ]
}, {
    type: "style",
    article: "MediaWiki:Common.css"
});

Esempi di sintassi alternativa

Il metodo importArticles() supporta anche una sintassi semplice ed alternativa per casi più comuni. Per convenienza il metodo importArticles() viene anche definito.

Inclusione di una pagina singola dalla wiki locale usando la definizione a moduli:

importArticle({
    type: "style",
    article: "MediaWiki:Common.css"
});

Vedere anche

Navigazione

Contenuti
Nozioni di base
Il tuo account Registrazione  • Login  • Preferenze  • Cambiare username
La tua wiki Creare una wiki  • Barra dei progressi della wiki  • Fondatori  • Tipi di utenti
Funzioni di Wikia Bacheca  • Notifiche  • Blog  • Forum  • Chat
Consigli Profilo  • Avatar  • Creare una wiki di successo  • Errori comuni
Contribuire
Aggiungere contenuti Nuova pagina  • Modifica  • Immagini  • Video
Formattazione VisualEditor  • Wikitext  • Stile della pagina  • Testo
Strumenti Wiki Activity  • Cronologia  • Aiuto:Barra degli strumenti  • Pagina di discussione Commenti  •
Suggerimenti Redirect  • Layout  • SEO  • La funzione Consigli  • Linee guida per le community
Gestire una community
Impostazioni Wiki Funzioni  • Pagine speciali  • Estensioni  • Protezione delle pagine
Strumenti per gli admin Pannello di controllo Admin  • Blocco degli utenti  • Strumento di benvenuto  • Angolo della Community
Design Theme Designer  • Menù di navigazione  • Pagina principale  • Pagina principale per mobile
Trucchi per la gestione Guida per gli Amministratori  • Costruire una community  • Regolamenti di una wiki  • Integrazione con i social
Nozioni avanzate
Estensioni Sondaggi  • Note  • DPL  • Mappe  • Funzioni parser
Strumenti & scorciatoie Messaggi di sistema  • Wikitext avanzato  • Parole magiche  • Esportare e importare pagine  • Caricare file multipli  • HTML
Consigli Titolo della pagina  • Descrizione  • Pratiche migliori per wikitext
Personalizzazione
Personalizzazione di base Theme Designer  • Sfondo  • Favicon  • Logo
Personalizzazione esperta Regole sulla personalizzazione  • CSS e JS della community  • CSS e JS personali  • CSS e JS avanzati
Tabelle e template Tabelle  • Infobox  • Template  • Parametri dei template
Altro... Tag per la pagina principale  • HeroImage  • Nuove gallerie immagini  • Lua
Mobile
Panoramica e consigli Introduzione alla versione mobile  • Pratiche migliori per wikitext  • Pagine principale su mobile  • Evitare tabelle nidificate
Prodotti per mobile App della Community  • Game guides  • Lyrically  • My Wikia
Trovare ulteriore aiuto
Consulta: Wiki della Community  • Blog di Wikia Italia  • Forum della Community  • Contatta Wikia  • Politiche di Wikia  • Aiuto di MediaWiki
I contenuti della comunità sono disponibili sotto la licenza CC-BY-SA a meno che non sia diversamente specificato.