Alternative zu Attribut options, in welcher Auswahl-Optionen für das Eingabefeld definiert werden

Dieses Attribut liest das angegebene Listenitem aus und übernimmt die Werte der Liste als Optionen für das Eingabefeld. Ebenso wie bei Attribut options ist die Trennung zwischen Anzeige- und Speicherungswert möglich, indem beide im selben Listenelement durch ein Pipe-Symbol getrennt werden.

Die Inhalte des Items werden automatisch bei der Ausgabe HTML-kodiert. Sie können als Inhalte also beliebige Zeichen verwenden.

Ebenso wie bei Tag <tml:item> können hier auch WebTML-Variablen als Items verwendet werden.

Ein Item namens "MyColors" im Kontextdokument besitzt folgende Werte als Liste:

Grün
Gelb
Blau

Diese Werte können als Optionen für ein Eingabefeld verwendet werden, wenn das Attribut optionsitem zum Einsatz kommt:

<tml:input name="color" type="select" optionsitem="MyColors"/>

Da auch WebTML-Variablen als Eingabe für das Attribut optionsitem verwendet werden können, ist es möglich eine Berechnung von Optionswerten in eine Variable speichern zu lassen. Folgendes Beispiel bietet die Unterdokumente des aktuellen Kontextes als Auswahlliste an, wobei die Dokumentenschlüssel gespeichert und die Dokumenttitel angezeigt werden:

<tml:script>
var docs = content().getStructEntry().getChildEntries();
theOptions = createList();
for (var idx=0; idx < docs.size(); idx++) {
    var doc = docs.get(idx);
    theOptions.add(doc.getTitle() + "|" + doc.getStructKey());
}
</tml:script>

<tml:input name="subdocs" type="select" optionsitem="theOptions"/>