„Benutzer:Schnark/js/wikieditor/Referenz“ – Versionsunterschied

aus Wikipedia, der freien Enzyklopädie
Zur Navigation springen Zur Suche springen
Inhalt gelöscht Inhalt hinzugefügt
Schnark-Bot (Diskussion | Beiträge)
K Bot: Ergänze __INDEX__ (Wunsch des Benutzers)
Zeile 1: Zeile 1:
__INDEX__
In diesem Teil der Dokumentation sind sämtliche Variablen und Funktionen des Skripts erläutert.
In diesem Teil der Dokumentation sind sämtliche Variablen und Funktionen des Skripts erläutert.



Version vom 1. Juni 2012, 10:45 Uhr

In diesem Teil der Dokumentation sind sämtliche Variablen und Funktionen des Skripts erläutert.

Externe Variablen

usersignature

string, optional, wird nach wikieditor.sig übertragen

customEditButtons

string, optional, wird nur verwendet, wenn keine benutzerdefinierte Konfigurationsfunktion vorhanden ist, Dokumentation siehe Wikipedia:Helferlein/Extra-Editbuttons

rmEditButtons

string oder object, optional, wird nur verwendet um die Schaltfläche für Formeln zu unterdrücken, falls customEditButtons verwendet wird, Dokumentation siehe Wikipedia:Helferlein/Extra-Editbuttons

charinsert

object, aus MediaWiki:Onlyifediting.js, wird für Sonderzeichentabellen ausgelesen

Externe Funktionen

newtoolbar_config

sollte Konfiguration durch Benutzer enthalten, wird vom Skript aufgerufen um Leiste zu modifizieren, optional (sonst Standardverhalten), wird nicht beachtet, wenn du meine Modulverwaltung verwendest

Variablen

wikieditor.sig

string, Benutzersignatur, Standardwert --~~~~, verwendet in allen Unterschriften

wikieditor.addSection_fn

object, für jeden Code wird die Funktion gespeichert, die über addSection aufgerufen werden kann

wikieditor.addGroup_fn

object, für jeden Code wird die Funktion gespeichert, die über addGroup aufgerufen werden kann

wikieditor.addChars_fn

object, für jeden Code wird die Funktion gespeichert, die über addChars aufgerufen werden kann

wikieditor.addTable_fn

object, für jeden Code wird die Funktion gespeichert, die über addTable aufgerufen werden kann

wikieditor.addButton_fn

object, für jeden Code wird die Funktion gespeichert, die über addButton aufgerufen werden kann

wikieditor.addSelect_fn

object, für jeden Code wird die Funktion gespeichert, die über addSelect aufgerufen werden kann

Funktionen

Hilfsfunktionen

wikieditor.ID

Parameter:

name
string, Name eines beliebigen Elements oder Leerstring
standard
string, Standardwert

Rückgabe: string, sonderzeichenbereinigte Version des Namens oder Standardwert (bei Leerstring)

Bereinigung von Sonderzeichen wahrscheinlich überflüssig, Aufruf durch außen sollte nur in Ausnahmefällen erfolgen

wikieditor.action

Parameter:

vorne
string, Text, der vor Cursor eingefügt werden soll
mitte
string, Beispieltext, der markiert eingefügt werden soll
hinten
string, Text, der hinter Cursor eingeführt werden soll
opt
object, optional, zusätzliche Parameter, etwa ownline oder splitlines, beide boolean
func
function, optional, Funktion, die zusätzlich ausgeführt werden soll

Rückgabe: object, enthält die Parameter geeignet für die Toolbar-API codiert

Aufruf durch außen sollte nicht erfolgen

wikieditor.addComment

Parameter

zuq
string, Text der in Zusammenfassungszeile eingefügt werden soll

Rückgabe: function, Funktion, die den Text in die Zusammenfassungszeile einfügt

Aufruf für den Funktionsparameter bei wikieditor.addMy(Button|Select) gedacht

wikieditor.CSSSelect

Parameter:

wo
string, Angabe des Orts der Auswahlliste
name
string, Name der Auswahlliste
liste
array, Einträge sind Arrays der Form ['Name des Punktes', 'Pfad zum Icon']

Rückgabe: keine

fügt CSS-Code zur Formatierung der Auswahlliste hinzu

wikieditor.addSection_fnd

Parameter:

was
string, Kürzel der section
name
string, optional, eigener Name für die section

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

wird aufgerufen, wenn für das Kürzel keine section definiert wurde

wikieditor.addGroup_fnd

Parameter:

wo
string, Angabe des Orts der Gruppe
was
string, Kürzel der Gruppe
name
string, optional, eigener Name für die Gruppe

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

wird aufgerufen, wenn für das Kürzel keine Gruppe definiert wurde

wikieditor.addChars_fnd

Parameter:

wo
string, Angabe des Orts der Zeichentabelle
was
string, Kürzel der Zeichentabelle
name
string, optional, eigener Name für die Zeichentabelle

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

wird aufgerufen, wenn für das Kürzel keine Zeichentabelle definiert wurde

wikieditor.addTable_fnd

Parameter:

wo
string, Angabe des Orts der Tabelle
was
string, Kürzel der Tabelle
name
string, optional, eigener Name für die Tabelle

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

wird aufgerufen, wenn für das Kürzel keine Tabelle definiert wurde

wikieditor.addButton_fnd

Parameter:

wo
string, Angabe des Orts der Schaltfläche
was
string, Kürzel der Schaltfläche
name
string, optional, eigener Name für die Schaltfläche

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

wird aufgerufen, wenn für das Kürzel keine Schaltfläche definiert wurde

wikieditor.addSelect_fnd

Parameter:

wo
string, Angabe des Orts der Auswahlliste
was
string, Kürzel der Auswahlliste
name
string, optional, eigener Name für die Auswahlliste

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

wird aufgerufen, wenn für das Kürzel keine Auswahlliste definiert wurde

Funktionen zum Hinzufügen

wikieditor.addMySection

Parameter

name
string, Name der neuen section
art
boolean, true für toolbar, false für booklet

Rückgabe: keine

fügt eine neue section mit dem angegebenen Namen in die Leiste ein

wikieditor.addMyGroup

Parameter

wo
string, Name der toolbar, in die die Gruppe eingefügt werden soll, Standard bei Leerstring ist main
name
string, Name der Gruppe

Rückgabe: keine

fügt eine neue Gruppe mit dem angegebenen Namen in die angegebene Werkzeugleiste ein

wikieditor.addMyChars

Parameter

wo
string, Name des Booklets (Standard bei Leerstring ist characters) bzw. Name des Booklets + '/' + Name der Zeichentabelle (Standard bei '/' ist characters/symbols, in die die Zeichen eingefügt werden sollen
name
string, Name der Zeichentabelle (falls nicht in bestehende Tabelle eingefügt wird)
zeichen
array, einzelne Elemente sind entweder vom Typ string (für einfache Zeichen), oder vom Typ array, in einer der Formen ['zeige', 'schreibe'], ['vorne', 'mitte', 'hinten'], ['vorne', 'mitte', 'hinten', 'Tooltip']
rtl
boolean, optional, bei true wird von rechts nach links geschrieben, Standard ist false

Rückgabe: keine

fügt eine Zeichentabelle ein

wikieditor.addMyTable

Parameter

wo
string, Name des Booklets, in das die Tabelle eingefügt werden soll, Standard bei Leerstring ist help
name
string, Name der Tabelle
tabelle
array, erstes Element ist Array mit Überschriften, nächste Elemente sind Arrays mit den Zellen der einzelnen Zeilen

Rückgabe: keine

fügt eine Tabelle ein

wikieditor.addMyButton

Parameter

wo
string, Name der Leiste (main bei Leerstring) + '/' + (kann entfallen, falls Leerstring danach) Name der Gruppe (insert bei Leerstring), dort wird der Button eingefügt
icon
string, URL des Icons
tooltip
string, Tooltip
vorne
string, siehe wikieditor.action
mitte
string, siehe wikieditor.action
hinten
string, siehe wikieditor.action
opt
object, optional, siehe wikieditor.action
func
function, optional, siehe wikieditor.action

Rückgabe: keine

fügt einen Button ein

wikieditor.addMySelect

Parameter

wo
string, siehe wikieditor.addMyButton
name
string, Name der Auswahlliste
liste
array, einzelne Elemente sind Arrays der Form [name, vorne, mitte, hinten, opt, funktion], wobei name die Bezeichnung des Punktes ist und die anderen Parameter mit denen von wikieditor.addMyButton übereinstimmen

Rückgabe: keine

fügt eine Auswahlliste ein

wikieditor.addInternalTool

Parameter:

wo
string, siehe wikieditor.addMyButton
section
string, interner Name der section des Tools
group
string, interner Name der group des Tools
name
string, interner Name des Tools selbst

Rückgabe: boolean, true

Fügt ein Standard-Tool an der vorgegebenen Stelle ein. Da die Funktion nicht fehlertolerant ist, sollte der Aufruf am besten über wikieditor.add(Button|Section) erfolgen.

Funktion zum Entfernen

wikieditor.remove

Parameter

was
string, Bezeichnung für das zu entfernende Objekt, entweder (Ebene 1) ein String ohne Schrägstriche (main und characters als Standard bei Leerstring) oder (Ebene 2) ein String für Ebene 1 gefolgt von einem Schrägstrich und einem Bezeichner für Ebene 2 (insert als Standard) oder (Ebene 3) ein String für Ebene 1 und 2 gefolgt von einem weiteren Schrägstrich und einem Bezeichner für Ebene 3 (Name eines Button/Selects/Zeichen).
art
boolean, true für toolbar, false für booklet

Rückgabe: keine

entfernt das angegebene Element

Funktionen zu vordefinierten Elementen

aus Benutzer:Schnark/js/wikieditor.js/de.js

wikieditor.addSection

Parameter

was
string, Kürzel für die section
name
string, optional, eigener Name für die section

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

fügt eine vordefinierte section ein

wikieditor.addGroup

Parameter

wo
string, siehe wikieditor.addMyGroup
was
string, Kürzel für die Gruppe
name
string, optional, eigener Name für die Gruppe

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

fügt eine vordefinierte Gruppe ein

wikieditor.addChars

Parameter

wo
string, siehe wikieditor.addMyChars
was
string, Bezeichnung der Zeichentabelle
name
string, optional, eigener Name für die Zeichentabelle

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

fügt eine vordefinierte Zeichentabelle ein

wikieditor.addTable

Parameter

wo
string, siehe wikieditor.addMyTable
was
string, Bezeichnung der Tabelle
name
string, optional, eigener Name für die Tabelle

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

fügt eine vordefinierte Tabelle ein

wikieditor.addButton

Parameter

wo
string, siehe wikieditor.addMyButton
was
string, Bezeichnung des Buttons
name
string, optional, eigener Name für den Button (könnte als Tooltip verwendet werden, wird aber ignoriert)

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

fügt einen vordefinierten Button ein

wikieditor.addSelect

Parameter

wo
string, siehe wikieditor.addMySelect
was
string, Bezeichnung der Auswahlliste
name
string, optional, eigener Name für die Auswahlliste

Rückgabe: boolean, true, falls (vermutlich) etwas eingefügt wurde, false, falls definitiv nichts eingefügt wurde

fügt eine vordefinierte Auswahlliste ein

wikieditor.standard

Parameter: keine, Rückgabe: keine

führt eine Standardkonfiguration durch


Dokumentation: EinleitungTeil 1Teil 2Teil 3Teil 4Teil 5

Skripte: wikieditor.jswikieditor.js/basic.jswikieditor.js/de.jsBenutzer:Schnark/js/wikieditor.js/global.jsListe von Beispielanwendungen

Alternativen: Beschreibung der Toolbar-API (englisch) • ähnliches, wesentlich kompakteres Skript von Benutzer:Krinkle (englisch) • alte Version des Skripts