Multiple (Einfach & Erweitert)

Ein Input Plugin kann über einen Plus und Minus Button mehrfach dupliziert werden.

Parameter-Name	Typ	Erforderlich	Beschreibung
input	Array	Ja	Die Parameter des Input Plugins.
inputs	Array	Ja	Innerhalb des Arrays können wie gewohnt alle Parameter der Input Plugins angegeben werden.
max	Integer	Nein	Maximale Anzahl an dupliziertem Plugin (Standard: unendlich).
onchange	String	Nein	Die Funktionsbezeichnung der Javascript Funktion, die nach dem Hinzufügen/Entfernen aufgerufen wird.
collapsible	Boolean	Nein	Die Darstellung erfolgt in einem Akkordeon.

Der Pflichtparameter ändert sich, je nach gewünschter Verwendung. (Erweitert oder Einfach)

Dieses Plugin erlaubt es eines oder mehrere Input Plugin zu duplizieren. So können Sie z.B. optional mehre Textfelder oder Links für die Eingabe anbieten. Gespeichert werden die Werte dieser Input Plugins in einem Array.

Beispiel eines einfachen Multiple:


{input type="multiple" name="test1" title="Multiple Text" input.type="text" input.placeholder="Input type=text"}

Beispiel eines erweiterten Multiple:


{input type="multiple" name="test4" title="Erweitertes Multiple (Text + Link)"
	inputs.0.type="text" inputs.0.name="test2" inputs.0.placeholder="Input type=text"
	inputs.1.type="link" inputs.1.name="test3" inputs.1.placeholder="Input type=link"
max="3"}

Ein Array aller Werte mit den Indizes 0 bis n ist über $page->extra.PLUGINNAME verwendbar.
Bei dem erweiterten Multiple Plugin werden die einzelnen Felder innerhalb des Arrays mit den gewählten Namen angesprochen (Im Beispiel entsprechend "link" und "text"). Beispiel:


[multi_extended] => [
	0 => [
		'text' => '',
		'link' => ''
	],
	1 => [
		'text' => '',
		'link' => ''
	]
]

Wenn Sie get_input_object verwenden um das Objekt eines multiple Input Plugins zu erhalten, können Sie mit getChildren() auf die Elemente zugreifen. Um sicherzustellen, dass die Elemente bereits geladen sind, wenn Sie auf diese zugreifen wollen, können Sie eine Callback Funktion übergeben, welche Ihnen die Elemente dann zurückliefert, sobald diese existieren.

Wenn Sie den Parameter onchange verwenden, wird nach dem Hinzufügen/Entfernen eines Elements die Funktion mit folgenden übergebenen Parametern aufgerufen: type = add oder remove, obj = das aktuelle MultipleHandler Objekt.