Wikipedia:Technik/Skin/JS/ResourceLoader - Versionsgeschichte

PerfektesChaos: t

2020-07-21T13:41:08Z

← Nächstältere Version		Version vom 21. Juli 2020, 15:41 Uhr
Zeile 303:		Zeile 303:
	* [[mw:ResourceLoader/Version 2 Design Specification\|Version 2 Design Specification]]		* [[mw:ResourceLoader/Version 2 Design Specification\|Version 2 Design Specification]]
	* [https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader Dokumentation] der Bibliotheksfunktionen		* [https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader Dokumentation] der Bibliotheksfunktionen
	* Phabricator-~~Diffusiuon~~ mit allen {{Phab\|dir=resources/src\|title=Quellcodes}}		* Phabricator-Diffusion mit allen {{Phab\|dir=resources/src\|title=Quellcodes}}

	[[Kategorie:Wikipedia:Technik/Skin\|ResourceLoader]]		[[Kategorie:Wikipedia:Technik/Skin\|ResourceLoader]]

PerfektesChaos: k

2020-01-22T14:42:58Z

← Nächstältere Version		Version vom 22. Januar 2020, 16:42 Uhr
Zeile 298:		Zeile 298:
	== Weitere Informationen ==		== Weitere Informationen ==
	(alle englisch)		(alle englisch)
	{{MediaWiki\|ResourceLoader\|3=Projektseite}}		{{MediaWiki\|ResourceLoader\|suffix=Projektseite}}
	* [[mw:ResourceLoader/Developing with ResourceLoader\|Developing]]		* [[mw:ResourceLoader/Developing with ResourceLoader\|Developing]]
	* [[mw:ResourceLoader/Migration guide (users)\|Migration guide (users)]]		* [[mw:ResourceLoader/Migration guide (users)\|Migration guide (users)]]

Giftpflanze: /* Benutzerkonfiguration */ doch sicher so, oder?

2019-03-22T14:15:32Z

Benutzerkonfiguration: doch sicher so, oder?

← Nächstältere Version		Version vom 22. März 2019, 16:15 Uhr
Zeile 262:		Zeile 262:
	Im Benutzerskript kann nicht mehr stehen:		Im Benutzerskript kann nicht mehr stehen:
	<syntaxhighlight lang="javascript" style="border: none; padding: 0; margin-left: 2em;">		<syntaxhighlight lang="javascript" style="border: none; padding: 0; margin-left: 2em;">
	if (window.thisGadget) }		if (window.thisGadget) {
	window.thisGadget.thatOption = true;		window.thisGadget.thatOption = true;
	}		}

PerfektesChaos: fix

2018-09-05T12:49:06Z

fix

← Nächstältere Version		Version vom 5. September 2018, 14:49 Uhr
Zeile 293:		Zeile 293:
	Da es aber ein normales Skript ist, könnte die Seite auch später dynamisch mit .loader.load() geladen werden. Um für diesen Fall den korrekten Status zu verdeutlichen und Interaktion mit anderen Skripten sicherzustellen, sollte zusätzlich am Ende vereinbart werden:		Da es aber ein normales Skript ist, könnte die Seite auch später dynamisch mit .loader.load() geladen werden. Um für diesen Fall den korrekten Status zu verdeutlichen und Interaktion mit anderen Skripten sicherzustellen, sollte zusätzlich am Ende vereinbart werden:
	<syntaxhighlight lang="javascript" style="border: none; padding: 0; margin-left: 2em;">		<syntaxhighlight lang="javascript" style="border: none; padding: 0; margin-left: 2em;">
	mw.loader.state("ext.gadget.meinHelferlein", "ready");		mw.loader.state( { "ext.gadget.meinHelferlein": "ready" } );
	</syntaxhighlight>		</syntaxhighlight>

PerfektesChaos: + user.defaults

2018-09-01T15:58:17Z

+ user.defaults

← Nächstältere Version		Version vom 1. September 2018, 17:58 Uhr
Zeile 77:		Zeile 77:
	::** <syntaxhighlight lang="css" inline>div.editoronly { display:block !important }</syntaxhighlight>		::** <syntaxhighlight lang="css" inline>div.editoronly { display:block !important }</syntaxhighlight>
	::* [[MediaWiki:Group-sysop.css]]		::* [[MediaWiki:Group-sysop.css]]
	: <code>user.~~options~~</code>		: <code>user.defaults</code>
	:: [[../Variablen#Benutzerkonfiguration\|Konfiguration]] ~~des~~ ~~momentanen~~ ~~Benutzers~~		:: [[../Variablen#Benutzerkonfiguration\|Konfiguration]] für alle Benutzer, einschließlich der nicht angemeldeten
			: <code>user.options</code><!-- seit 2018-08 -->
			:: Spezifische [[../Variablen#Benutzerkonfiguration\|Konfiguration]] des momentan angemeldeten Benutzers; überschreibt ggf. Komponenten von <code>user.defaults</code>
	: <code>ext.gadget.Zeitzonenkonverter</code>		: <code>ext.gadget.Zeitzonenkonverter</code>
	:: [[../../Gadgets\|Projektweites Helferlein]]; hier: [[MediaWiki:Gadget-Zeitzonenkonverter]]		:: [[../../Gadgets\|Projektweites Helferlein]]; hier: [[MediaWiki:Gadget-Zeitzonenkonverter]]

PerfektesChaos: updates

2018-09-01T10:54:38Z

updates

PerfektesChaos: updates

2018-08-27T12:08:34Z

updates

← Nächstältere Version		Version vom 27. August 2018, 14:08 Uhr
Zeile 201:		Zeile 201:
	:* <code>source</code>: aktuelles Wikiprojekt (wgLoadScript; Vorgabe), oder anderes Wiki; Pfad vor <code>load.php</code>		:* <code>source</code>: aktuelles Wikiprojekt (wgLoadScript; Vorgabe), oder anderes Wiki; Pfad vor <code>load.php</code>
	: Erster Parameter Pflicht, Rest optional.		: Erster Parameter Pflicht, Rest optional.
	; mw.loader.state(~~module, state~~) {{Anker\|.loader.state()}}		; mw.loader.state(modules) {{Anker\|.loader.state()}}
	: Setze den Status ~~einer~~ ~~Ressource~~.		: Setze den Status von Ressourcen.
			: Dabei ist ''modules'' ein <code>object</code> mit Zuweisungen ID→state.<!-- 2018-08-23 1.32.0-wmf.18 -->
	: Siehe [[#.loader.getState()\|.loader.getState()]]		: Siehe [[#.loader.getState()\|.loader.getState()]]
	; mw.loader.store {{Anker\|.loader.store}}		; mw.loader.store {{Anker\|.loader.store}}
Zeile 294:		Zeile 295:
	* [[mw:ResourceLoader/Migration guide (users)\|Migration guide (users)]]		* [[mw:ResourceLoader/Migration guide (users)\|Migration guide (users)]]
	* [[mw:ResourceLoader/Version 2 Design Specification\|Version 2 Design Specification]]		* [[mw:ResourceLoader/Version 2 Design Specification\|Version 2 Design Specification]]
			* [https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader Dokumentation] der Bibliotheksfunktionen
	* MW-~~GIT~~ mit allen {{Phab\|dir=resources/src\|title=Quellcodes}}		* Phabricator-Diffusiuon mit allen {{Phab\|dir=resources/src\|title=Quellcodes}}

	[[Kategorie:Wikipedia:Technik/Skin\|ResourceLoader]]		[[Kategorie:Wikipedia:Technik/Skin\|ResourceLoader]]

PerfektesChaos: update

2018-06-18T16:28:59Z

update

← Nächstältere Version		Version vom 18. Juni 2018, 18:28 Uhr
Zeile 1:		Zeile 1:
			{{../../../!header
	{{Shortcut}}
			\|Text=ResourceLoader}}
	{{../Linkbox}}
	{{Überschriftensimulation 1\|ResourceLoader}}

	Der '''ResourceLoader''' (RL) ist ein Bestandteil von [[MediaWiki]], über den sich dynamisch [[JavaScript\|JS]]- und [[Cascading Style Sheets\|CSS]]-Definitionen in das [[Hypertext Markup Language\|HTML]]-Dokument einer Wiki-Seite einbinden lassen.		Der '''ResourceLoader''' (RL) ist ein Bestandteil von [[MediaWiki]], über den sich dynamisch [[JavaScript\|JS]]- und [[Cascading Style Sheets\|CSS]]-Definitionen in das [[Hypertext Markup Language\|HTML]]-Dokument einer Wiki-Seite einbinden lassen.

Zeile 173:		Zeile 171:
	: ''Wirkung:'' Die Funktion wird ausgeführt oder die Skript-Quellen werden von den angegebenen URL abgerufen, indem <script src=> in das Dokument eingefügt wird. War das Laden erfolgreich, wird der Status <code>loaded</code> gesetzt; <code>missing</code> oder <code>error</code> wenn ein Fehler detektiert wurde. Über die Registrierung hinaus erfolgt zurzeit auch immer das tatsächliche Laden. Im Erfolgsfall wird nach aufgelaufenen unbefriedigten Abhängigkeiten gesucht; sind keine mehr vorhanden, wird <code>ready</code> für das Modul ausgewiesen. Schließlich werden eventuelle Funktionen aus der .loader.using()-Warteschlange ausgeführt.		: ''Wirkung:'' Die Funktion wird ausgeführt oder die Skript-Quellen werden von den angegebenen URL abgerufen, indem <script src=> in das Dokument eingefügt wird. War das Laden erfolgreich, wird der Status <code>loaded</code> gesetzt; <code>missing</code> oder <code>error</code> wenn ein Fehler detektiert wurde. Über die Registrierung hinaus erfolgt zurzeit auch immer das tatsächliche Laden. Im Erfolgsfall wird nach aufgelaufenen unbefriedigten Abhängigkeiten gesucht; sind keine mehr vorhanden, wird <code>ready</code> für das Modul ausgewiesen. Schließlich werden eventuelle Funktionen aus der .loader.using()-Warteschlange ausgeführt.
	: ''Konzept:'' Während [[#.loader.register()\|.loader.register()]] ein einheitliches Modul weltweit unter einer URL (auf bits.wikimedia.org) zugänglich macht und die offizielle Verteilung der Systemnachrichten über translatewiki nutzt, ermöglicht .loader.implement() eine einzelne, örtliche Vereinbarung eines Moduls. Es kann unter verschiedenen URL in verschiedenen Wikiprojekten und in verschieden weit entwickelten Versionen ein Modul bereitgestellt werden. Im Inneren kann bereits so programmiert werden, als ob es sich um ein „offizielles“ Modul handeln würde, also etwa mittels Systemnachrichten.		: ''Konzept:'' Während [[#.loader.register()\|.loader.register()]] ein einheitliches Modul weltweit unter einer URL (auf bits.wikimedia.org) zugänglich macht und die offizielle Verteilung der Systemnachrichten über translatewiki nutzt, ermöglicht .loader.implement() eine einzelne, örtliche Vereinbarung eines Moduls. Es kann unter verschiedenen URL in verschiedenen Wikiprojekten und in verschieden weit entwickelten Versionen ein Modul bereitgestellt werden. Im Inneren kann bereits so programmiert werden, als ob es sich um ein „offizielles“ Modul handeln würde, also etwa mittels Systemnachrichten.
	; mw.loader.inspect(reports) {{Anker\|.loader.inspect()}}		; <s>mw.loader.inspect(reports)</s> {{Anker\|.loader.inspect()}}
	: ~~Analysiere~~ die bekannten und geladenen Module zu Testzwecken.		: Analysierte die bekannten und geladenen Module zu Testzwecken.
	: ~~Gibt~~ auf Debugging-Konsolen (Firebug, zurzeit nicht aber Dragonfly) eine Liste der geladenen Modul-IDs aus; dazu die Code-Größe statischer Module ~~auf <nowiki>https://bits.wikimedia.org/</nowiki>~~ und Angaben zum CSS. Die Tabelle ~~ist~~ ggf. sortierbar, falls <code>console.table()</code> unterstützt wird.		: Gab auf Debugging-Konsolen (Firebug, zurzeit nicht aber Dragonfly) eine Liste der geladenen Modul-IDs aus; dazu die Code-Größe statischer Module und Angaben zum CSS. Die Tabelle war ggf. sortierbar, falls <code>console.table()</code> unterstützt wird.
			: Nicht mehr verfügbar; siehe jedoch: [[../mw#.inspect\|mw.inspect]]
	; mw.loader.load() {{Anker\|.loader.load()}}		; mw.loader.load() {{Anker\|.loader.load()}}
	:* '''.loader.load(URL, MIME, async)'''		:* '''.loader.load(URL, MIME, async)'''
Zeile 237:		Zeile 236:
	Bisher war es so, dass ''zuerst'' die [[Wikipedia:Helferlein\|Helferlein]] (Gadgets) geladen und ausgeführt wurden, danach die [[#user\|Standardressourcen des Benutzers]].		Bisher war es so, dass ''zuerst'' die [[Wikipedia:Helferlein\|Helferlein]] (Gadgets) geladen und ausgeführt wurden, danach die [[#user\|Standardressourcen des Benutzers]].

	Das ~~ändert~~ sich 2011/2012:		Das änderte sich 2011/2012:
	# Schnelle Browser mit asynchronem Laden von Ressourcen halten sich nicht mehr unbedingt an eine Reihenfolge im Ablauf.		# Schnelle Browser mit asynchronem Laden von Ressourcen halten sich nicht mehr unbedingt an eine Reihenfolge im Ablauf.
	# Der ResourceLoader stellt alle vom Benutzer angeforderten (und bereits als dazu geeignet markierten) Gadgets zu einem [[#Pakete\|Paket]] zusammen.		# Der ResourceLoader stellt alle vom Benutzer angeforderten (und bereits als dazu geeignet markierten) Gadgets zu einem [[#Pakete\|Paket]] zusammen.

Perhelion: /* mw.loader */ MIME neuer Versuch, nunja ein klein wenig lächerlich ist es schon

2017-06-05T22:16:01Z

mw.loader: MIME neuer Versuch, nunja ein klein wenig lächerlich ist es schon

← Nächstältere Version		Version vom 6. Juni 2017, 00:16 Uhr
Zeile 180:		Zeile 180:
	:*: Siehe [[../../JS#loader.load()\|Laden anderer Skripte]] für JavaScript und CSS, etwa Benutzerskripte.		:*: Siehe [[../../JS#loader.load()\|Laden anderer Skripte]] für JavaScript und CSS, etwa Benutzerskripte.
	:: <code>URL</code>: ''string''; nur <code>//</code> oder <code>http://</code> oder <code>https://</code>		:: <code>URL</code>: ''string''; nur <code>//</code> oder <code>http://</code> oder <code>https://</code>
	:: <code>MIME</code>: ''string''; Vorgabe <code>application/javascript</code> – sonst nur <code>text/css</code>		:: <code>MIME</code>: ''string''; Vorgabe <code>application/javascript</code> – sonst nur <code>text/css</code> (momentan ist noch <code>text/javascript</code> Vorgabe)
	:: <code>async</code>: ''boolean'' <!-- MW 1.19 -->		:: <code>async</code>: ''boolean'' <!-- MW 1.19 -->
	::* <code>true</code> (Vorgabe) – URL asynchron laden, auch wenn ''document.ready'' noch nicht eingetreten war.		::* <code>true</code> (Vorgabe) – URL asynchron laden, auch wenn ''document.ready'' noch nicht eingetreten war.

PerfektesChaos: 166117027 von Perhelion rückgängig gemacht; es ist genau umgekehrt, https://www.w3.org/TR/html5/scripting-1.html#scriptingLanguages – text war früher, endete mit JS 1.5, application ist neuer und ecmascript hochmodern

2017-06-05T21:54:03Z

166117027 von Perhelion rückgängig gemacht; es ist genau umgekehrt, https://www.w3.org/TR/html5/scripting-1.html#scriptingLanguages – text war früher, endete mit JS 1.5, application ist neuer und ecmascript hochmodern

← Nächstältere Version		Version vom 6. Juni 2017, 00:16 Uhr
Zeile 180:		Zeile 180:
	:*: Siehe [[../../JS#loader.load()\|Laden anderer Skripte]] für JavaScript und CSS, etwa Benutzerskripte.		:*: Siehe [[../../JS#loader.load()\|Laden anderer Skripte]] für JavaScript und CSS, etwa Benutzerskripte.
	:: <code>URL</code>: ''string''; nur <code>//</code> oder <code>http://</code> oder <code>https://</code>		:: <code>URL</code>: ''string''; nur <code>//</code> oder <code>http://</code> oder <code>https://</code>
	:: <code>MIME</code>: ''string''; Vorgabe <code>application/javascript</code> – sonst nur <code>text/css</code>		:: <code>MIME</code>: ''string''; Vorgabe <code>application/javascript</code> – sonst nur <code>text/css</code> (momentan ist noch <code>text/javascript</code> Vorgabe)
	:: <code>async</code>: ''boolean'' <!-- MW 1.19 -->		:: <code>async</code>: ''boolean'' <!-- MW 1.19 -->
	::* <code>true</code> (Vorgabe) – URL asynchron laden, auch wenn ''document.ready'' noch nicht eingetreten war.		::* <code>true</code> (Vorgabe) – URL asynchron laden, auch wenn ''document.ready'' noch nicht eingetreten war.

← Nächstältere Version		Version vom 1. September 2018, 12:54 Uhr
Zeile 39:		Zeile 39:

	=== PHP auf dem Server ===		=== PHP auf dem Server ===
	Diese Seite beschreibt schwerpunktmäßig den ResourceLoader auf der Browser-Seite in JavaScript; als Gegenstück gibt es einen analogen in [[PHP]] geschriebenen ResourceLoader auf den Servern, namentlich unter <code>/w/load.php</code> oder auf bits.wikimedia.org zur Zusammenstellung.		Diese Seite beschreibt schwerpunktmäßig den ResourceLoader auf der Browser-Seite in JavaScript; als Gegenstück gibt es einen analogen in [[PHP]] geschriebenen ResourceLoader auf den Servern, namentlich unter <code>/w/load.php</code> (oder früher auf bits.wikimedia.org) zur Zusammenstellung.
	* {{Phab\|file=resources/Resources.php}} – Zusammenstellung der Module (möglicherweise bereits zukünftige Version)		* {{Phab\|file=resources/Resources.php}} – Zusammenstellung der Module (möglicherweise bereits zukünftige Version)
	* {{Phab\|file=load.php}} – ResourceLoader		* {{Phab\|file=load.php}} – ResourceLoader
Zeile 128:		Zeile 128:

	== Browser-Cache ==		== Browser-Cache ==
	An die ~~URL auf <code>//bits.wikimedia.org</code>~~ mittels <code>load.php</code> wird die jeweils jüngste Änderungszeit auf dem Server mit einer Genauigkeit von zehn Sekunden angefügt. Damit hat jedes Paket eine eindeutige URL, die sich von veralteten Versionen im [[Browser-Cache]] unterscheidet. Somit bleibt Browsern und Proxy-Servern nichts anderes übrig, als die aktuelle Version herunterzuladen.		An die mittels <code>load.php</code> gebildete URL wird die jeweils jüngste Änderungszeit auf dem Server mit einer Genauigkeit von zehn Sekunden angefügt. Damit hat jedes Paket eine eindeutige URL, die sich von veralteten Versionen im [[Browser-Cache]] unterscheidet. Somit bleibt Browsern und Proxy-Servern nichts anderes übrig, als die aktuelle Version herunterzuladen.

	Für die Standardressourcen des Projekts und Benutzers sowie Gadgets wird vom Server dieser Zeitschlüssel an die URL angefügt.		Für die Standardressourcen des Projekts und Benutzers sowie Gadgets wird vom Server dieser Zeitschlüssel an die URL angefügt.
Zeile 137:		Zeile 137:
	Im [[../mw\|mw-Objekt]] steht der ResourceLoader als Komponente <code>.loader</code> zur Verfügung.		Im [[../mw\|mw-Objekt]] steht der ResourceLoader als Komponente <code>.loader</code> zur Verfügung.
	* [[mw:ResourceLoader/Default modules#mediaWiki.loader\|mw:mediaWiki.loader]] – Beschreibung (englisch)		* [[mw:ResourceLoader/Default modules#mediaWiki.loader\|mw:mediaWiki.loader]] – Beschreibung (englisch)
	* {{Phab\|file=resources/src/~~mediawiki~~/mediawiki.js~~\|line=644~~}}~~<!-- Tracken wir mal die Zeilennummer -->~~ – Quellcode		* {{Phab\|file=resources/src/startup/mediawiki.js}} – Quellcode
	* [https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader Kurzdokumentation]		* [https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader Kurzdokumentation]

Zeile 155:		Zeile 155:
	:* "<code>missing</code>" – Zugriff auf die URL dieses Moduls gescheitert.		:* "<code>missing</code>" – Zugriff auf die URL dieses Moduls gescheitert.
	:* <code>null</code> – Modulname ist nicht bekannt.		:* <code>null</code> – Modulname ist nicht bekannt.
	: Wenn eine Wiki-Seite geladen wurde, sind die Registrierungsinformationen aller ~~unter //bits.wikimedia.org~~ nutzbaren Module (einschließlich Versionsinfo) definiert; zunächst als <code>registered</code>, ggf. auch schon als <code>ready</code>.		: Wenn eine Wiki-Seite geladen wurde, sind die Registrierungsinformationen aller nutzbaren Module (einschließlich Versionsinfo) definiert; zunächst als <code>registered</code>, ggf. auch schon als <code>ready</code>.
	; mw.loader.getVersion(module) {{Anker\|.loader.getVersion()}}		; mw.loader.getVersion(module) {{Anker\|.loader.getVersion()}}
	: Versionsinformation einer Ressource abfragen – definiert in .loader.register().		: Versionsinformation einer Ressource abfragen – definiert in .loader.register().
Zeile 162:		Zeile 162:
	:* String – ISO8601 ''YYYYMMDD''T''hhmmss''Z, oder "<code>19700101T000000Z</code>" wenn nicht vereinbart.		:* String – ISO8601 ''YYYYMMDD''T''hhmmss''Z, oder "<code>19700101T000000Z</code>" wenn nicht vereinbart.
	:* <code>null</code> – Modulname ist nicht bekannt		:* <code>null</code> – Modulname ist nicht bekannt
	; mw.loader.implement(module, script, style, msgs, templates) {{Anker\|.loader.implement()}}		; <s>mw.loader.implement(module, script, style, msgs, templates) {{Anker\|.loader.implement()}}</s>
	: Deklaration eines neuen Modulnamens, Verbindung mit der zugehörigen Implementierung und Laden.		: Deklaration eines neuen Modulnamens, Verbindung mit der zugehörigen Implementierung und Laden.
	: Alle Parameter bis auf den Modulnamen sind optional; gleichwohl muss sinnvollerweise mindestens einer die Implementierung enthalten.		: Alle Parameter bis auf den Modulnamen sind optional; gleichwohl muss sinnvollerweise mindestens einer die Implementierung enthalten.
Zeile 170:		Zeile 170:
	:* <code>msgs</code>: Objekt; benötigte Systemnachrichten, die den [[../mw#.messages\|.messages]] hinzuzufügen sind, als key:value – nicht <code>null</code>.		:* <code>msgs</code>: Objekt; benötigte Systemnachrichten, die den [[../mw#.messages\|.messages]] hinzuzufügen sind, als key:value – nicht <code>null</code>.
	: ''Wirkung:'' Die Funktion wird ausgeführt oder die Skript-Quellen werden von den angegebenen URL abgerufen, indem <script src=> in das Dokument eingefügt wird. War das Laden erfolgreich, wird der Status <code>loaded</code> gesetzt; <code>missing</code> oder <code>error</code> wenn ein Fehler detektiert wurde. Über die Registrierung hinaus erfolgt zurzeit auch immer das tatsächliche Laden. Im Erfolgsfall wird nach aufgelaufenen unbefriedigten Abhängigkeiten gesucht; sind keine mehr vorhanden, wird <code>ready</code> für das Modul ausgewiesen. Schließlich werden eventuelle Funktionen aus der .loader.using()-Warteschlange ausgeführt.		: ''Wirkung:'' Die Funktion wird ausgeführt oder die Skript-Quellen werden von den angegebenen URL abgerufen, indem <script src=> in das Dokument eingefügt wird. War das Laden erfolgreich, wird der Status <code>loaded</code> gesetzt; <code>missing</code> oder <code>error</code> wenn ein Fehler detektiert wurde. Über die Registrierung hinaus erfolgt zurzeit auch immer das tatsächliche Laden. Im Erfolgsfall wird nach aufgelaufenen unbefriedigten Abhängigkeiten gesucht; sind keine mehr vorhanden, wird <code>ready</code> für das Modul ausgewiesen. Schließlich werden eventuelle Funktionen aus der .loader.using()-Warteschlange ausgeführt.
	: ''Konzept:'' Während [[#.loader.register()\|.loader.register()]] ein einheitliches Modul weltweit unter einer URL (auf bits.wikimedia.org) zugänglich macht und die offizielle Verteilung der Systemnachrichten über translatewiki nutzt, ermöglicht .loader.implement() eine einzelne, örtliche Vereinbarung eines Moduls. Es kann unter verschiedenen URL in verschiedenen Wikiprojekten und in verschieden weit entwickelten Versionen ein Modul bereitgestellt werden. Im Inneren kann bereits so programmiert werden, als ob es sich um ein „offizielles“ Modul handeln würde, also etwa mittels Systemnachrichten.
	; <s>mw.loader.inspect(reports)</s> {{Anker\|.loader.inspect()}}		; <s>mw.loader.inspect(reports)</s> {{Anker\|.loader.inspect()}}
	: Analysierte die bekannten und geladenen Module zu Testzwecken.		: Analysierte die bekannten und geladenen Module zu Testzwecken.
Zeile 193:		Zeile 192:
	:*: Soll anschließend eine Funktion ausgeführt werden, wäre [[#.loader.using()\|.loader.using()]] zu verwenden. Wenn das Skript selbst eine Art AutoRun-Funktion enthält, kann .loader.load() benutzt werden.		:*: Soll anschließend eine Funktion ausgeführt werden, wäre [[#.loader.using()\|.loader.using()]] zu verwenden. Wenn das Skript selbst eine Art AutoRun-Funktion enthält, kann .loader.load() benutzt werden.
	; mw.loader.register(module, version, dependencies, group, source) {{Anker\|.loader.register()}}		; mw.loader.register(module, version, dependencies, group, source) {{Anker\|.loader.register()}}
	: Registrierung eines Moduls zum Abruf über <code>load.php</code> (von //bits.wikimedia.org)		: Registrierung eines Moduls zum Abruf über <code>load.php</code> <s>(von //bits.wikimedia.org)</s>
	: Für Benutzerskripte nicht nutzbar.		: Für Benutzerskripte nicht nutzbar.
	:* <code>module</code>: String mit Modulnamen, oder Array.		:* <code>module</code>: String mit Modulnamen, oder Array.
	:* <code>version</code>: Versionsnummer; erlaubt Unterscheidung im Browser-Cache.<br />Erwartet wird die Anzahl der Sekunden seit dem 1. Januar 1970, 00:00:00.<br />Es handelt sich nur um den Zeitpunkt, zu dem die Ressource im Dateisystem ankam – nicht um eine inhaltliche Versionsnummer im Sinne einer Weiterentwicklung. Eine jüngere Version kann einen älteren Inhalt beschreiben, beispielsweise nach einem Revert.		:* <code>version</code>: Versionsnummer; erlaubt Unterscheidung im Browser-Cache.<br /> Erwartet wird die Anzahl der Sekunden seit dem 1. Januar 1970, 00:00:00.<br />Es handelt sich nur um den Zeitpunkt, zu dem die Ressource im Dateisystem ankam – nicht um eine inhaltliche Versionsnummer im Sinne einer Weiterentwicklung. Eine jüngere Version kann einen älteren Inhalt beschreiben, beispielsweise nach einem Revert.
	:* <code>dependencies</code>: Abhängigkeiten; Array→String oder einzelner String oder Function→Array.		:* <code>dependencies</code>: Abhängigkeiten; Array→String oder einzelner String oder Function→Array.
	:* <code>group</code>: Übergeordneter Modulname, wenn <code>module</code> ein Untermodul ist.		:* <code>group</code>: Übergeordneter Modulname, wenn <code>module</code> ein Untermodul ist.
	:* <code>source</code>: aktuelles Wikiprojekt (wgLoadScript; Vorgabe), oder anderes Wiki; Pfad vor <code>load.php</code>		:* <code>source</code>: aktuelles Wikiprojekt (wgLoadScript; Vorgabe), oder anderes Wiki; Pfad vor <code>load.php</code>
	: Erster Parameter Pflicht, Rest optional.		: Erster Parameter Pflicht, Rest optional.
			; mw.loader.require(module) {{Anker\|.loader.require()}}
			: Status einer Ressource sichern: Wenn noch nicht bereit, dann Fehler auslösen.
			: Ermöglicht das Aufspüren vergessener Abhängigkeiten aus tieferen Schichten.
			:* <code>module</code>: String mit Modulname
			: Gleichgesetzt mit <code>window.require()</code> – nur in dieser Form soll es in produktivem Code verwendet werden.
			: Bei über [[#.loader.using()\|.using()]] angeforderten Modulen wird die Funktionsdefinition zurückgegeben.
	; mw.loader.state(modules) {{Anker\|.loader.state()}}		; mw.loader.state(modules) {{Anker\|.loader.state()}}
	: Setze den Status von Ressourcen.		: Setze den Status von Ressourcen.

← Nächstältere Version		Version vom 5. Juni 2017, 23:54 Uhr
Zeile 102:		Zeile 102:
	# Wenn die welt- und projektweite [[#Grundausstattung\|Grundausstattung]] einer Seite bereitgestellt wird („Startup“) – spezifisch für jede Skin.		# Wenn die welt- und projektweite [[#Grundausstattung\|Grundausstattung]] einer Seite bereitgestellt wird („Startup“) – spezifisch für jede Skin.
	# Wenn die [[../../Gadgets\|Gadgets]] anhand der Benutzerkonfiguration ausgeliefert werden.		# Wenn die [[../../Gadgets\|Gadgets]] anhand der Benutzerkonfiguration ausgeliefert werden.
	# Wenn eine [[#.loader.using()\|.loader.using()]]-Anforderung abgearbeitet wurde und dabei fehlende Module festgestellt wurden.		# Wenn eine [[#.loader.using()\|.loader.using()]]-Anforderung abgearbeitet wurde und dabei fehlende Module festgestellt wurden.
	Es werden auf einen Schlag einerseits alle Skripte, andererseits alle angeforderten CSS-Definitionen geladen. Jede URL erhält eine [[#Browser-Cache\|Versionsidentifikation]] (Zeitstempel).		Es werden auf einen Schlag einerseits alle Skripte, andererseits alle angeforderten CSS-Definitionen geladen. Jede URL erhält eine [[#Browser-Cache\|Versionsidentifikation]] (Zeitstempel).

Zeile 130:		Zeile 130:

	== Browser-Cache ==		== Browser-Cache ==
	An die URL auf <code>//bits.wikimedia.org</code> mittels <code>load.php</code> wird die jeweils jüngste Änderungszeit auf dem Server mit einer Genauigkeit von zehn Sekunden angefügt. Damit hat jedes Paket eine eindeutige URL, die sich von veralteten Versionen im [[Browser-Cache]] unterscheidet. Somit bleibt Browsern und Proxy-Servern nichts anderes übrig, als die aktuelle Version herunterzuladen.		An die URL auf <code>//bits.wikimedia.org</code> mittels <code>load.php</code> wird die jeweils jüngste Änderungszeit auf dem Server mit einer Genauigkeit von zehn Sekunden angefügt. Damit hat jedes Paket eine eindeutige URL, die sich von veralteten Versionen im [[Browser-Cache]] unterscheidet. Somit bleibt Browsern und Proxy-Servern nichts anderes übrig, als die aktuelle Version herunterzuladen.

	Für die Standardressourcen des Projekts und Benutzers sowie Gadgets wird vom Server dieser Zeitschlüssel an die URL angefügt.		Für die Standardressourcen des Projekts und Benutzers sowie Gadgets wird vom Server dieser Zeitschlüssel an die URL angefügt.
Zeile 138:		Zeile 138:
	== mw.loader ==		== mw.loader ==
	Im [[../mw\|mw-Objekt]] steht der ResourceLoader als Komponente <code>.loader</code> zur Verfügung.		Im [[../mw\|mw-Objekt]] steht der ResourceLoader als Komponente <code>.loader</code> zur Verfügung.
	* [[mw:ResourceLoader/Default modules#mediaWiki.loader\|mw:mediaWiki.loader]] – Beschreibung (englisch)		* [[mw:ResourceLoader/Default modules#mediaWiki.loader\|mw:mediaWiki.loader]] – Beschreibung (englisch)
	* {{Phab\|file=resources/src/mediawiki/mediawiki.js\|line=644}}<!-- Tracken wir mal die Zeilennummer --> – Quellcode		* {{Phab\|file=resources/src/mediawiki/mediawiki.js\|line=644}}<!-- Tracken wir mal die Zeilennummer --> – Quellcode
	* [https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader Kurzdokumentation]		* [https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader Kurzdokumentation]
Zeile 144:		Zeile 144:
	; mw.loader.addSource(modules, props) {{Anker\|.loader.addSource()}}		; mw.loader.addSource(modules, props) {{Anker\|.loader.addSource()}}
	: Registrierung einer URL (für load.php gedacht) zu einem Quellcode. <!-- MW 1.19 -->		: Registrierung einer URL (für load.php gedacht) zu einem Quellcode. <!-- MW 1.19 -->
	; mw.loader.getModuleNames() {{Anker\|.loader.getModuleNames()}}		; mw.loader.getModuleNames() {{Anker\|.loader.getModuleNames()}}
	: Array mit allen bekannten Modulnamen. <!-- MW.19 -->		: Array mit allen bekannten Modulnamen. <!-- MW.19 -->
	; mw.loader.getState(module) {{Anker\|.loader.getState()}}		; mw.loader.getState(module) {{Anker\|.loader.getState()}}
	: Status einer Ressource abfragen.		: Status einer Ressource abfragen.
	:* <code>module</code>: String mit Modulname.		:* <code>module</code>: String mit Modulname.
Zeile 158:		Zeile 158:
	:* <code>null</code> – Modulname ist nicht bekannt.		:* <code>null</code> – Modulname ist nicht bekannt.
	: Wenn eine Wiki-Seite geladen wurde, sind die Registrierungsinformationen aller unter //bits.wikimedia.org nutzbaren Module (einschließlich Versionsinfo) definiert; zunächst als <code>registered</code>, ggf. auch schon als <code>ready</code>.		: Wenn eine Wiki-Seite geladen wurde, sind die Registrierungsinformationen aller unter //bits.wikimedia.org nutzbaren Module (einschließlich Versionsinfo) definiert; zunächst als <code>registered</code>, ggf. auch schon als <code>ready</code>.
	; mw.loader.getVersion(module) {{Anker\|.loader.getVersion()}}		; mw.loader.getVersion(module) {{Anker\|.loader.getVersion()}}
	: Versionsinformation einer Ressource abfragen – definiert in .loader.register().		: Versionsinformation einer Ressource abfragen – definiert in .loader.register().
	:* <code>module</code>: String mit Modulname.		:* <code>module</code>: String mit Modulname.
Zeile 164:		Zeile 164:
	:* String – ISO8601 ''YYYYMMDD''T''hhmmss''Z, oder "<code>19700101T000000Z</code>" wenn nicht vereinbart.		:* String – ISO8601 ''YYYYMMDD''T''hhmmss''Z, oder "<code>19700101T000000Z</code>" wenn nicht vereinbart.
	:* <code>null</code> – Modulname ist nicht bekannt		:* <code>null</code> – Modulname ist nicht bekannt
	; mw.loader.implement(module, script, style, msgs, templates) {{Anker\|.loader.implement()}}		; mw.loader.implement(module, script, style, msgs, templates) {{Anker\|.loader.implement()}}
	: Deklaration eines neuen Modulnamens, Verbindung mit der zugehörigen Implementierung und Laden.		: Deklaration eines neuen Modulnamens, Verbindung mit der zugehörigen Implementierung und Laden.
	: Alle Parameter bis auf den Modulnamen sind optional; gleichwohl muss sinnvollerweise mindestens einer die Implementierung enthalten.		: Alle Parameter bis auf den Modulnamen sind optional; gleichwohl muss sinnvollerweise mindestens einer die Implementierung enthalten.
Zeile 173:		Zeile 173:
	: ''Wirkung:'' Die Funktion wird ausgeführt oder die Skript-Quellen werden von den angegebenen URL abgerufen, indem <script src=> in das Dokument eingefügt wird. War das Laden erfolgreich, wird der Status <code>loaded</code> gesetzt; <code>missing</code> oder <code>error</code> wenn ein Fehler detektiert wurde. Über die Registrierung hinaus erfolgt zurzeit auch immer das tatsächliche Laden. Im Erfolgsfall wird nach aufgelaufenen unbefriedigten Abhängigkeiten gesucht; sind keine mehr vorhanden, wird <code>ready</code> für das Modul ausgewiesen. Schließlich werden eventuelle Funktionen aus der .loader.using()-Warteschlange ausgeführt.		: ''Wirkung:'' Die Funktion wird ausgeführt oder die Skript-Quellen werden von den angegebenen URL abgerufen, indem <script src=> in das Dokument eingefügt wird. War das Laden erfolgreich, wird der Status <code>loaded</code> gesetzt; <code>missing</code> oder <code>error</code> wenn ein Fehler detektiert wurde. Über die Registrierung hinaus erfolgt zurzeit auch immer das tatsächliche Laden. Im Erfolgsfall wird nach aufgelaufenen unbefriedigten Abhängigkeiten gesucht; sind keine mehr vorhanden, wird <code>ready</code> für das Modul ausgewiesen. Schließlich werden eventuelle Funktionen aus der .loader.using()-Warteschlange ausgeführt.
	: ''Konzept:'' Während [[#.loader.register()\|.loader.register()]] ein einheitliches Modul weltweit unter einer URL (auf bits.wikimedia.org) zugänglich macht und die offizielle Verteilung der Systemnachrichten über translatewiki nutzt, ermöglicht .loader.implement() eine einzelne, örtliche Vereinbarung eines Moduls. Es kann unter verschiedenen URL in verschiedenen Wikiprojekten und in verschieden weit entwickelten Versionen ein Modul bereitgestellt werden. Im Inneren kann bereits so programmiert werden, als ob es sich um ein „offizielles“ Modul handeln würde, also etwa mittels Systemnachrichten.		: ''Konzept:'' Während [[#.loader.register()\|.loader.register()]] ein einheitliches Modul weltweit unter einer URL (auf bits.wikimedia.org) zugänglich macht und die offizielle Verteilung der Systemnachrichten über translatewiki nutzt, ermöglicht .loader.implement() eine einzelne, örtliche Vereinbarung eines Moduls. Es kann unter verschiedenen URL in verschiedenen Wikiprojekten und in verschieden weit entwickelten Versionen ein Modul bereitgestellt werden. Im Inneren kann bereits so programmiert werden, als ob es sich um ein „offizielles“ Modul handeln würde, also etwa mittels Systemnachrichten.
	; mw.loader.inspect(reports) {{Anker\|.loader.inspect()}}		; mw.loader.inspect(reports) {{Anker\|.loader.inspect()}}
	: Analysiere die bekannten und geladenen Module zu Testzwecken.		: Analysiere die bekannten und geladenen Module zu Testzwecken.
	: Gibt auf Debugging-Konsolen (Firebug, zurzeit nicht aber Dragonfly) eine Liste der geladenen Modul-IDs aus; dazu die Code-Größe statischer Module auf <nowiki>https://bits.wikimedia.org/</nowiki> und Angaben zum CSS. Die Tabelle ist ggf. sortierbar, falls <code>console.table()</code> unterstützt wird.		: Gibt auf Debugging-Konsolen (Firebug, zurzeit nicht aber Dragonfly) eine Liste der geladenen Modul-IDs aus; dazu die Code-Größe statischer Module auf <nowiki>https://bits.wikimedia.org/</nowiki> und Angaben zum CSS. Die Tabelle ist ggf. sortierbar, falls <code>console.table()</code> unterstützt wird.
	; mw.loader.load() {{Anker\|.loader.load()}}		; mw.loader.load() {{Anker\|.loader.load()}}
	:* '''.loader.load(URL, MIME, async)'''		:* '''.loader.load(URL, MIME, async)'''
	:*: Siehe [[../../JS#loader.load()\|Laden anderer Skripte]] für JavaScript und CSS, etwa Benutzerskripte.		:*: Siehe [[../../JS#loader.load()\|Laden anderer Skripte]] für JavaScript und CSS, etwa Benutzerskripte.
	:: <code>URL</code>: ''string''; nur <code>//</code> oder <code>http://</code> oder <code>https://</code>		:: <code>URL</code>: ''string''; nur <code>//</code> oder <code>http://</code> oder <code>https://</code>
	:: <code>MIME</code>: ''string''; Vorgabe <code>~~text~~/javascript</code> – sonst nur <code>text/css</code>		:: <code>MIME</code>: ''string''; Vorgabe <code>application/javascript</code> – sonst nur <code>text/css</code>
	:: <code>async</code>: ''boolean'' <!-- MW 1.19 -->		:: <code>async</code>: ''boolean'' <!-- MW 1.19 -->
	::* <code>true</code> (Vorgabe) – URL asynchron laden, auch wenn ''document.ready'' noch nicht eingetreten war.		::* <code>true</code> (Vorgabe) – URL asynchron laden, auch wenn ''document.ready'' noch nicht eingetreten war.
Zeile 193:		Zeile 193:
	:*: War das Modul bereits geladen gewesen, sollte nichts weiter passieren.		:*: War das Modul bereits geladen gewesen, sollte nichts weiter passieren.
	:*: Soll anschließend eine Funktion ausgeführt werden, wäre [[#.loader.using()\|.loader.using()]] zu verwenden. Wenn das Skript selbst eine Art AutoRun-Funktion enthält, kann .loader.load() benutzt werden.		:*: Soll anschließend eine Funktion ausgeführt werden, wäre [[#.loader.using()\|.loader.using()]] zu verwenden. Wenn das Skript selbst eine Art AutoRun-Funktion enthält, kann .loader.load() benutzt werden.
	; mw.loader.register(module, version, dependencies, group, source) {{Anker\|.loader.register()}}		; mw.loader.register(module, version, dependencies, group, source) {{Anker\|.loader.register()}}
	: Registrierung eines Moduls zum Abruf über <code>load.php</code> (von //bits.wikimedia.org)		: Registrierung eines Moduls zum Abruf über <code>load.php</code> (von //bits.wikimedia.org)
	: Für Benutzerskripte nicht nutzbar.		: Für Benutzerskripte nicht nutzbar.
Zeile 202:		Zeile 202:
	:* <code>source</code>: aktuelles Wikiprojekt (wgLoadScript; Vorgabe), oder anderes Wiki; Pfad vor <code>load.php</code>		:* <code>source</code>: aktuelles Wikiprojekt (wgLoadScript; Vorgabe), oder anderes Wiki; Pfad vor <code>load.php</code>
	: Erster Parameter Pflicht, Rest optional.		: Erster Parameter Pflicht, Rest optional.
	; mw.loader.state(module, state) {{Anker\|.loader.state()}}		; mw.loader.state(module, state) {{Anker\|.loader.state()}}
	: Setze den Status einer Ressource.		: Setze den Status einer Ressource.
	: Siehe [[#.loader.getState()\|.loader.getState()]]		: Siehe [[#.loader.getState()\|.loader.getState()]]
	; mw.loader.store {{Anker\|.loader.store}}		; mw.loader.store {{Anker\|.loader.store}}
	: Abspeicherung im persistenten [[WebStorage]] verwalten (Objekt).		: Abspeicherung im persistenten [[WebStorage]] verwalten (Objekt).
	:* '''.loader.store.clear()'''		:* '''.loader.store.clear()'''
Zeile 211:		Zeile 211:
	:* '''.loader.store.enabled''' = false;		:* '''.loader.store.enabled''' = false;
	:*: Verhindere Abspeicherung im <code>localStorage</code> des Browsers.		:*: Verhindere Abspeicherung im <code>localStorage</code> des Browsers.
	; mw.loader.using(dependencies, ready, error) {{Anker\|.loader.using()}}		; mw.loader.using(dependencies, ready, error) {{Anker\|.loader.using()}}
	: Starte eine Funktion, nachdem ein Modul geladen wurde, oder wenn dies fehlschlug; lade fehlende weitere Module nach.		: Starte eine Funktion, nachdem ein Modul geladen wurde, oder wenn dies fehlschlug; lade fehlende weitere Module nach.
	: Rückgabewert<!-- MW1.23 --> ist ein Objekt vom Typ [http://api.jquery.com/jQuery.Deferred/ <code>jQuery.Promise</code>], auf das weitere [[Wikipedia:Technik/Skin/JS/API#Callback\|Callback-Vereinbarungen]] angewendet werden können. Die reguläre ''done''-Funktion ist bereits der zweite Parameter.		: Rückgabewert<!-- MW1.23 --> ist ein Objekt vom Typ [http://api.jquery.com/jQuery.Deferred/ <code>jQuery.Promise</code>], auf das weitere [[Wikipedia:Technik/Skin/JS/API#Callback\|Callback-Vereinbarungen]] angewendet werden können. Die reguläre ''done''-Funktion ist bereits der zweite Parameter.
Zeile 226:		Zeile 226:
	Um ein bibliotheksartiges Benutzer-Skript (übergangsweise) für bedarfsweises Laden durch den ResourceLoader auszustatten, ist wie folgt vorzugehen:		Um ein bibliotheksartiges Benutzer-Skript (übergangsweise) für bedarfsweises Laden durch den ResourceLoader auszustatten, ist wie folgt vorzugehen:
	# Eindeutigen und langfristig haltbaren [[#Name\|Modul-Namen]] vergeben.		# Eindeutigen und langfristig haltbaren [[#Name\|Modul-Namen]] vergeben.
	# Am Ende des Skriptes mit [[#.loader.state()\|<code>.loader.state(</code>''name''<code>, "ready")</code>]] das abgeschlossene Laden deklarieren. Falls das Skript zuvor auf eine andere Weise geladen würde, wird ein unnötiger und möglicherweise zu Fehlfunktionen führender mehrfacher Abruf vermieden.		# Am Ende des Skriptes mit [[#.loader.state()\|<code>.loader.state(</code>''name''<code>, "ready")</code>]] das abgeschlossene Laden deklarieren. Falls das Skript zuvor auf eine andere Weise geladen würde, wird ein unnötiger und möglicherweise zu Fehlfunktionen führender mehrfacher Abruf vermieden.
	# Auf sorgfältige und syntaktisch einwandfreie Programmierung achten.		# Auf sorgfältige und syntaktisch einwandfreie Programmierung achten.
	# Den Anwendern den Modul-Namen bekanntgeben sowie mögliche URL mit den Quellen.		# Den Anwendern den Modul-Namen bekanntgeben sowie mögliche URL mit den Quellen.