FS_LIST
Die Eingabekomponente FS_LIST ermöglicht die Erstellung von Listen auf der Basis von FirstSpirit-Daten unterschiedlicher Herkunft bzw. Typen.
Auf welche Daten FS_LIST zurückgreifen soll, wird über den Parameter type im Tag DATASOURCE definiert:
<FS_LIST name="BEZEICHNER">
<DATASOURCE type="DATENTYP">
...
Folgende Datentypen stehen zur Verfügung:
Typ | Erstellen und Verwalten von | ersetzt |
---|---|---|
Datensatzlisten | CMS_INPUT_CONTENTLIST, CMS_INPUT_TABLIST | |
INLINE | Absatzlisten | CMS_INPUT_CONTENTAREALIST |
INLINE | Verweislisten | CMS_INPUT_LINKLIST |
Liste der Absätze einer Seite | CMS_INPUT_SECTIONLIST | |
Listen mit Daten aus externen Modulen / Komponenten | ||
Je nach Anwendungsfall können für FS_LIST vielfältige Funktionen und Darstellungsweisen konfiguriert werden. Die verwendbaren Tags und Parameter von FS_LIST sind auf den Unterseiten dieser Seite nach Datentyp separat aufgelistet und dokumentiert. Diese sind ebenfalls über die Verweise in der oben dargestellten Tabelle erreichbar.
Die Syntax von FS_LIST ist mit Version 4.2R4 überarbeitet worden, daher müssen Verwendungen von FS_LIST, die mit einer FirstSpirit-Version unterhalb von 4.2R4 erstellt worden sind, entsprechend der unten angegebenen Syntax angepasst werden. |
Wichtiger Hinweis zur Schachtelung von FS_LIST-Eingabekomponenten In FS_LIST-Eingabekomponenten können wiederum andere FS_LIST-Eingabekomponenten verwendet werden („Schachtelung“, siehe beispielsweise auch diese Seite). Werden zu viele Schachtelungen vorgenommen, kann dies nicht nur zu Problemen hinsichtlich der Bedienbarkeit (Usability) für Redakteure und der Wartbarkeit in der Entwicklung führen, sondern auch zu Performance-Beeinträchtigungen. Erfahrungen haben gezeigt, dass nach Möglichkeit Schachtelungen über 3 Ebenen hinaus vermieden werden sollten! Speziell wird davon abgeraten, bei Verwendung von FS_LIST, Typ INLINE / SECTIONTEMPLATES, sprachabhängige Eingabekomponenten miteinander zu verschachteln (also sprachabhängige FS_LIST-Eingabekomponente mit sprachabhängigen Eingabekomponenten, siehe dazu auch Parameter useLanguages). Insbesondere in Kombination mit Regeln kann dies zu nicht-speicherbaren Konfigurationen führen! |
Beispiele
Ein Beispiel für die Eingabekomponente FS_LIST ab Version 4.2R4:
<FS_LIST name="BEZEICHNER" rows="5">
<DATASOURCE type="database" useLanguages="no">
<ACTIONS>
<ACTION name="ADD"/>
<ACTION name="REMOVE"/>
<ACTION name="UP"/>
<ACTION name="DOWN"/>
<ACTION name="GOTO"/>
<ACTION name="EDIT"/>
</ACTIONS>
<COLUMNS>
<COLUMN show="no">#identifier</COLUMN>
</COLUMNS>
<LAYOUT>
<ADD component="toolbar" constraint="top"/>
<ADD component="overview" constraint="center"/>
<ADD component="stackedview" constraint="bottom"/>
</LAYOUT>
<table>TABELLENVORLAGE</table>
</DATASOURCE>
<LANGINFOS>
<LANGINFO lang="*" label="Datensatzauswahl"/>
</LANGINFOS>
</FS_LIST>
Ein Beispiel für die Eingabekomponente FS_LIST bis zur Version 4.2R2 einschließlich:
<FS_LIST name="BEZEICHNER" hFill="YES">
<LANGINFOS>
<LANGINFO lang="DE" label="TEXT" description="TEXT"/>
<LANGINFO lang="*" label="TEXT" description="TEXT"/>
</LANGINFOS>
<SOURCES>
<TEMPLATE name="BEZEICHNER_ABSATZVORLAGE"/>
</SOURCES>
</FS_LIST>
Siehe dazu auch das Beispielprojekt.