JavaScript bietet die Möglichkeit, Funktionen als Parameter an andere Funktionen zu übergeben. Eine als Parameter übergebene Funktion wird als Callback-Funktion bezeichnet. So kann realisiert werden, dass eine beliebige Funktion im Kontext der ausführenden Funktion ausgeführt wird. Häufig wird dieses Konzept genutzt um sicherzustellen, dass eine bestimmte Funktion erst ausgeführt wird, wenn die ausführende Funktion oder Teile dieser abgearbeitet sind. Insbesondere bei asynchronen AJAX Aufrufen ist dieses Konzept notwendig und wird häufig verwendet.
Einige Funktionen der JavaScript API (insbesondere jene, die Dialoginhalte dynamisch nachladen oder aktualisieren) haben als Übergabeparameter Callback-Funktionen. Dadurch erhalten Sie eine hohe Flexibilität um bestimmte Ereignisse selbst zu behandeln und eine weitgehende Kontrolle über deren ausgelöstes Verhalten. In der Regel bieten die entsprechenden Funktionen der JavaScript API jeweils die Möglichkeit zur Übergabe einer Callback-Funktion für den Erfolgsfall, sowie einer Callback-Funktion für den Fehlerfall.
Weiterführende Informationen zu Callback-Funktionen in JavaScript finden Sie unter:
•http://learn.jquery.com/about-jquery/how-jquery-works/#callbacks-and-functions
•http://www.w3schools.com/jquery/jquery_callback.asp
Achtung: Bitte beachten Sie, dass bei der Übergabe von Callback-Funktionen lediglich der Funktionsname angegeben werden darf. Dieser darf nicht von einfachen oder doppelten Hochkommas eingeschlossen sein. Weiterhin dürfen keine runden Klammern nach dem Funktionsnamen geschrieben werden.
Bitte beachten Sie: Wenn in einem Prozess mehrere JavaScript Skripte in einem Dialog eingebunden werden, muss für eindeutige Namen der Callback-Funktionen gesorgt werden. Sonst kann nicht sichergestellt werden, welche Callback-Funktion aufgerufen wird.
Korrektes Beispiel:
function mySqlTextboxSuccessCallback() { … };
function mySqlTextboxErrorCallback() { … };
jr_sql_refresh("my_sqltextbox", mySqlTextboxSuccessCallback, mySqlTextboxErrorCallback);
Fehlerhaftes Beispiel 1:
function mySqlTextboxSuccessCallback() { … };
function mySqlTextboxErrorCallback() { … };
jr_sql_refresh("my_sqltextbox", "mySqlTextboxSuccessCallback", "mySqlTextboxErrorCallback");
Fehler: Hier werden die Callback-Funktionen als Zeichenkette übergeben.
Fehlerhaftes Beispiel 2:
function mySqlTextboxSuccessCallback() { … };
function mySqlTextboxErrorCallback() { … };
jr_sql_refresh("my_sqltextbox", mySqlTextboxSuccessCallback(), mySqlTextboxErrorCallback());
Fehler: Hier werden die Callback-Funktionen bereits bei der Übergabe aufgerufen.
