imported>PerfektesChaos: k

2018-06-17T18:12:14Z

Neue Seite

{{../../../!header
|Text=wikEd und JavaScript-Programmierung}}
Diese Seite beschreibt Besonderheiten der JavaScript-Programmierung für oder mit dem Texteditor '''[[../../../Text/Edit/wikEd|wikEd]]'''.

== Konfiguration ==

Ab September 2010 wurden die Konfigurationsvariablen von wikEd durch Eigenschaften des Objekts <code>window.wikEd.config.</code>… ersetzt. Die Existenz dieses Objekts (<code>typeof(window.wikEd) === "object")</code>) zeigt die mögliche Aktivität von wikEd an und sollte sicherheitshalber vor Zugriff im Skript geprüft werden. Beispiel:
<syntaxhighlight lang="javascript">
if (! mw.config.get("wgIsArticle")) {
if ( /^(edit|submit)$/.test( mw.config.get("wgAction") ) ) {
if (window.wikEd) {
window.wikEd.config.filePreview = false;
}
}
}
</syntaxhighlight>
; Miniaturbilder im Quelltext
: <code>window.wikEd.config.filePreview</code> (2010-09…)
:: nicht anzeigen:   <code> = false;</code>
: ''überholt:''
:: <code>window.wikEdFilePreview</code> (…2010-08/09)
::: nicht anzeigen:   <code> = false;</code>
; wikEd aktiv
: <code>window.wikEd.config.disabled</code>
::: <code>=== true</code>   – ist vorhanden, aber nicht aktiv
: <code>window.wikEd.useWikEd</code>
:: = true/false   – Benutzung ist zeitweilig vom Benutzer deaktiviert worden; sollte vor jeder externen Manipulation geprüft werden, da wikEd bei seinen internen Aktivitäten davon ausgeht, dass es aktiv ist.

== Synchronisation ==
Für Benutzerskripte in Zusammenarbeit mit wikEd sind wichtig:
; Synchronisation des Wikitextes
: <code>window.wikEd.UpdateFrame()</code>
:: Überträgt den Inhalt aus der allgemeinen HTML-Textbox <code>wpTextbox1</code> nach WikEd.
: <code>window.wikEd.UpdateTextarea()</code>
:: Überträgt den WikEd-Inhalt in die allgemeine HTML-Textbox <code>wpTextbox1</code>.
; Initialisierung
: Falls auf modernen Browsern Skripte parallel geladen werden, kann es vorkommen, dass beim beendeten Laden des Dokuments (ready) wikEd zwar geladen, aber noch nicht initialisiert worden war, während das aktuelle Skript bereits gestartet wurde. Mit
:: <code>window.wikEd.Setup();</code>
: sollte dies sicherheitshalber vor Benutzung der anderen Funktionen ausgelöst werden. Falls das Setup bereits anderweitig erfolgt war, schadet das nicht. Die Existenz des Objektes <code>wikEd</code> zeigt an, dass das wikEd-Skript geladen wurde. Nachdem die Seite geladen wurde, erfolgt wikEd.Setup() und die Aktivitäten von wikEd können danach trotzdem zeitweilig <code>disabled</code> werden.

== Sonstige Konfigurationsmöglichkeiten ==
* Die Werkzeugleiste kann um eigene Buttons ergänzt werden, und es können bis zu zwei eigene Werkzeugleisten hinzugefügt werden.
* Es gibt Hook-Funktionen für verschiedene Phasen der Steuerung.

== Wechselnde Browser ==
Die einfache Einbindung per Häkchen in den Helferlein ist immer wirksam. WikEd arbeitet aber nur mit Gecko-Browsern zusammen, also in erster Linie Firefox. Wechselt jemand häufig den Browser, führt dies möglicherweise im Internet Explorer zu Fehlern. Eine bedingte Einbindung kann über die [[Special:Mypage/common.js|eigene common.js]] in Abhängigkeit vom momentanen Browser erfolgen:
<syntaxhighlight lang="javascript" style="margin-left:2em">
if ( jQuery.client.profile().layout === "gecko" ) {
mw.loader.load( "//en.wikipedia.org/w/index.php?title=User:Cacycle/wikEd.js&action=raw&bcache=1&maxage=86400&ctype=text/javascript" );
}
</syntaxhighlight>

Dabei ist <code>[[Wikipedia:Technik/Skin/JS/jQuery#jquery.client|jQuery.client]]</code> ein Modul, dessen Laden zuvor geprüft worden sein muss.

== Weitere Informationen ==
* [[:en:User:Cacycle/wikEd development #wikEd API]]
* [[:en:User:Cacycle/wikEd customization]]

[[Kategorie:Wikipedia:Technik/Skin/JavaScript]]

Wikipedia:Technik/Skin/JS/wikEd - Versionsgeschichte

imported>PerfektesChaos: k