Start page / Template development / Forms / Input components (new) / FS_LIST

FS_LIST

While the input component FS_LIST up to and including Version 4.2R2 enables the selection and display of several sections as a list (as with the input component CMS_INPUT_CONTENTAREALIST), in Version 4.2R4 and higher it enables lists to be created on the basis of FirstSpirit data with different origin and types and therefore includes the functions of the input components: CMS_INPUT_CONTENTAREALIST, CMS_INPUT_LINKLIST, CMS_INPUT_CONTENTLIST, CMS_INPUT_TABLIST and CMS_INPUT_SECTIONLIST.

The type parameter in the DATASOURCE tag is used to define which data FS_LIST is to access:

<FS_LIST name="IDENTIFIER">
   <DATASOURCE type="DATATYPE">
    ...

The following data types are available:

Type	Creation and management of	replaces
DATABASE	Data record lists	CMS_INPUT_CONTENTLIST, CMS_INPUT_TABLIST
INLINE (<TEMPLATES source="sectiontemplates"/>)	Section lists	CMS_INPUT_CONTENTAREALIST
INLINE (<TEMPLATES source="linktemplates"/>)	Link lists	CMS_INPUT_LINKLIST
PAGE	List of the sections on a page	CMS_INPUT_SECTIONLIST
SERVICE	Lists with data from external modules / components

Depending on the application case, diverse functions and types of display can be configured for FS_LIST. The tags and parameters that can be used by FS_LIST are listed and documented separately on the following sub-pages by data type. They can also be opened using the links in the table shown above.

The syntax of FS_LIST was revised with Version 4.2R4, therefore, uses of FS_LIST created with a FirstSpirit version lower than 4.2R4 must be adjusted in line with the syntax given below.

This input component has "under development" status in FirstSpirit Version 4.2 and will not be officially released until FirstSpirit Version 5.0. For further information, please refer to the New input components section.

In WebEdit, only rudimentary support is provided for FS_LIST in 4.2R4, not all the functions are available. For details of the restrictions, see the Restrictions in WebEdit section.

Examples

An example of the input component FS_LIST in Version 4.2R4 and higher:

<FS_LIST name="IDENTIFIER" 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>TABLETEMPLATE</table>
      </DATASOURCE>
      <LANGINFOS>
        <LANGINFO lang="*" label="Selection of data sets"/>
      </LANGINFOS>
    </FS_LIST>

An example of the input component FS_LIST up to and including Version 4.2R2:

<FS_LIST name="IDENTIFIER" hFill="YES">
    <LANGINFOS>     
       <LANGINFO lang="DE" label="TEXT" description="TEXT"/>   
       <LANGINFO lang="*" label="TEXT" description="TEXT"/>
    </LANGINFOS>
    <SOURCES>
      <TEMPLATE name="IDENTIFIER_SECTIONTEMPLATE"/>
    </SOURCES>
</FS_LIST>