Alle Plugins teilen sich eine Vielzahl an Parametern und können so noch feiner konfiguriert werden. Viele Parameter werden automatisch mit Standardwerten gefüllt und müssen nicht angegeben werden.
| Parameter-Name | Typ | Erforderlich | Beschreibung |
| name | String | Ja |
Name des Plugins |
| title | String | Nein |
Titel des Plugins |
| short | String | Nein |
Kurzbeschreibung des Plugins |
| width | Integer | Nein |
Breite des Eingabeelements |
| labelWidth | Integer | Nein |
Breite des Titelelements |
| small | Boolean | Nein |
Kleines (Breite = 144px) Eingabeelement verwenden (ist z.B. bei Number immer aktiv) |
| standalone | Boolean | Nein |
Keinen Titel anzeigen |
| extendedHTML | String | Nein |
HTML das direkt nach dem Eingabeelement ausgegeben wird (praktisch um z.B. Plugins zu kombinieren) |
| disabled | Boolean | Nein |
Deaktiviert das Eingabeelement |
| value | mixed | Nein |
Ein Standardwert |
| onchange | callable | Nein |
Ein Javascript Aufruf der ausgeführt wird wenn sich der Wert geändert hat |
| onevent | callable | Nein |
Die meisten Events (wie Beispielsweise onClick, onKeyDown, usw.) können so abgefangen werden. Beispielsweise: onclick="alert('Klick')" |
| condition | String | Nein |
Input Plugin nur bei Erfüllung dieser Bedingung anzeigen. Details |
Innerhalb Ihrer onchange Funktion können Sie über set_input.info auf weitere Informationen des eingetragenen Wertes zugreifen. Bei z.B. einer ausgewählten Seiten, können Sie so den Namen der Seite abfragen.
Validierung
Die Input Plugins text, file, image, link und password kennen zusätzlich den Parameter regex. Über diesen können Sie einen regulären Ausdruck angeben, mit welchem der eingetragene Wert geprüft wird. Im Fehlerfall werden ein Hinweistext und eine rote Markierung dargestellt. Der Parameter regex ist ein Array und kennt folgende Einstellungen:
- pattern: Der reguläre Ausdruck (ohne Delimiter).
- invalid: Die Meldung die bei einem ungültigen Wert angezeigt wird (optional, es gibt einen Standardtext).
- prompt: Die Meldung die als Hilfetext zu diesem Feld angezeigt wird (optional).
- missing: Die Meldung die zu diesem Feld angezeigt wird, wenn dieses leer ist (optional).
Im folgenden Beispiel sind nur Werte erlaubt, die mit http:// oder https:// beginnen:
{input type="text" name="url" title="Externe URL" regex.pattern="https?://" regex.invalid="Bitte geben Sie eine URL mit Protokoll an."}
Ist der Wert ungültig, wird er nicht gespeichert.