Startseite / Vorlagenentwicklung / Formulare / Eingabekomponenten / LIST (neu)

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
DATABASE	Datensatzlisten	CMS_INPUT_CONTENTLIST, CMS_INPUT_TABLIST
INLINE (<TEMPLATES source="sectiontemplates"/>)	Absatzlisten	CMS_INPUT_CONTENTAREALIST
INLINE (<TEMPLATES source="linktemplates"/>)	Verweislisten	CMS_INPUT_LINKLIST
PAGE	Liste der Absätze einer Seite	CMS_INPUT_SECTIONLIST
SERVICE	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>

Siehe dazu auch das Beispielprojekt.

Druckversion | Seitenanfang