#listitem
Das Systemobjekt #listitem steht in der Formatvorlage mit dem Kürzel li zur Verfügung. Im Gegensatz zum Systemobjekt #list (das Informationen zu der gesamten Liste zurückliefert) liefert das Systemobjekt #listitem Informationen zu einem einzelnen Listenpunkt zurück.
Listen können in folgenden Eingabekomponenten gepflegt werden:
Die allgemeine Syntax des Systemobjektes sieht so aus:
$CMS_VALUE(#listitem.METHODE)$
In der nachfolgenden Tabelle sind die Methoden des Systemobjektes #listitem aufgeführt:
Aufruf | Bedeutung | Rückgabedatentyp |
|---|---|---|
#listitem.index | Nummer des aktuellen Listenelements. Die Zählung beginnt mit 1, wenn der Parameter #list.start nicht gesetzt wurde, ansonsten mit dem Wert von #list.start. | |
#listitem.indexText | Beschriftung des aktuellen Listenelements. Dies entspricht der im Client angezeigten Beschriftung vor dem Listenelement. | Listentyp Benutzerdefiniert Text: |
#listitem.pre | Liefert den Wert zurück, der für die Eingabekomponente Benutzerdefinierter Text vom Redakteur in der Liste eingegeben wurde. Der Rückgabewert ist uninterpretiert, d.h. Platzhalter (z.B. %count%, %index% usw.) werden nicht ersetzt. | String |
1. Beispiel: Automatische Listennummerierung unter Berücksichtigung eine Startwertes
<li>
$CMS_VALUE(#listitem.index)$ / $CMS_VALUE(#list.count2)$: $CMS_VALUE(#content)$
</li>
Das Beispiel gibt ein Listenelement mit einer automatischen Nummerierung aus. Bei der Verwendung von #listitem.index wird ein abweichender Startwert für die Nummerierung (siehe auch Parameter listDefaultConfig der Eingabekomponenten DOM und DOMTABLE) automatisch berücksichtigt. Damit der Startwert auch für die Nummerierung des letzten Listenelements berücksichtigt wird, kann #list.count2 verwendet werden.
Exemplarische Ausgabe:
<li>
257 / 261: 1. Wert
</li>
<li>
258 / 261: 2. Wert
</li>
<li>
259 / 261: 3. Wert
</li>
<li>
260 / 261: 4. Wert
</li>
<li>
261 / 261: 5. Wert
</li>