|
jr_add_subtable_row(string subtableViewName, mixed rows, boolean ignoreMaxRows, function finishCallback) |
Scroll Zurück Oben Weiter Mehr |
Die Funktion fügt eine oder mehrere Zeilen zu einer Untertabellenansicht hinzu.
Parameter |
Typ |
Beschreibung |
|---|---|---|
subtableViewName |
string |
Name der Untertabellenansicht |
rows |
int | object | array |
int: Anzahl der Zeilen, die zu der Ansicht hinzugefügt werden sollen object: JavaScript-Objekt mit den Werten für eine einzelne Zeile array: Array mit JavaScript-Objekten, jedes mit den Werten für eine einzelne Zeile |
ignoreMaxRows (optional) |
boolean |
Mit diesem Parameter kann eingestellt werden, ob die Validierung auf die maximale Anzahl der Zeilen deaktiviert werden soll. Standardmäßig ist die Validierung aktiviert (false). |
finishCallback (optional) |
function |
Callback-Funktion, die nach dem Hinzufügen aller Zeilen einmal ausgeführt wird. Als Parameter wird ihr die Anzahl der erfolgreich hinzugefügten Zeilen übergeben. |
Diese Funktion liefert keinen Rückgabewert.
Ist bei der Untertabellenansicht eine Callback-Funktion Before Add hinterlegt, wird diese vor dem Hinzufügen jeder einzelnen Zeile aufgerufen.
Ist bei der Untertabellenansicht eine Callback-Funktion After Add hinterlegt, wird diese nach dem Hinzufügen jeder einzelnen Zeile aufgerufen.
Hinweis: Diese Funktion führt einen AJAX-Request durch. Daher kann die Funktion nicht mehrmals direkt hintereinander ausgeführt werden, z.B. in einer Schleife, sondern es muss immer die Fertigstellung des vorigen AJAX-Requests vor der nächsten Ausführung abgewartet werden.
Beispiel 1: Eine leere Zeile mit Callback-Funktion hinzufügen
var myFinishCallback = function(addedRows) {
console.log(addedRows);
}
jr_add_subtable_row('mySubtableView', 1, false, myFinishCallback);
Beispiel 2: Eine Zeile mit Daten hinzufügen
jr_add_subtable_row('mySubtableView', {
company: 'Acme Ltd.',
city: 'London'
});
Beispiel 3: Mehrere Zeilen über ein Array hinzufügen
jr_add_subtable_row('mySubtableView', [
{
company: 'Acme Ltd.',
city: 'London'
},
{
company: 'JobRouter AG',
city: 'Mannheim'
}
]);
