<we:listdir></we:listdir>

Erzeugt eine Liste aller Dateien im aktuellen Verzeichnis oder in dem Verzeichnis, dessen ID als Wert des Attributs "id" angegeben wurde.

Innerhalb des Start- und Endtags können folgende we:Tags verwendet werden:

TagBedeutung
<we:field/> Zeigt den Dateinamen oder den Inhalt des beim Attribut "field" angegebenen Feldes an
<we:id/> Zeigt die ID des webEdition-Dokuments an
<we:path/> Zeigt den Pfad an
<we:a>Linktext</we:a> Erzeugt einen Link auf das Dokument
<we:ifSelf></we:ifSelf> Wird nur ausgeführt, wenn es sich um dasselbe webEdition-Dokument handelt.
<we:ifNotSelf></we:ifNotSelf> Wird nur ausgeführt, wenn es sich nicht um dasselbe webEdition-Dokument handelt.

Beachte, dass Du für diese Tags keine Attribute anzugeben brauchst und sich die Funktionalität von den gleichnamigen we:Tags unterscheidet, wenn sie innerhalb der <we:listdir>-Tags stehen.

Endtag erforderlich ja
Pflichtattribute

Attribute

id Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die ID des Verzeichnisses an, dessen Dateien aufgelistet werden sollen. Ist das Attribut nicht gesetzt, werden die Dateien des aktuellen Verzeichnisses aufgelistet.

Typ string
Standardwert -
index Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert kommasepariert die Index-Dateien an.

Typ string
Standardwert -
field Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert den Namen eines Feldes an, welches sich in den aufzulistenden webEition-Dokumenten befindet und dessen Inhalt angezeigt werden soll. Ist das Feld leer oder gibt es das Feld nicht, wird der Dateiname angezeigt. Bei Verzeichnissen wird überprüft, ob es darin eine über das Attribut "index" definierte Index-Datei gibt und wenn ja, wird ein Link auf diese angezeigt.

Typ string
Standardwert -
dirfield Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert den Namen eines Feldes an, welches bei Verzeichnissen angezeigt werden soll. Ist das Feld leer oder gibt es das Feld nicht, wird der Wert des Attributs "field" bzw. der Dateiname benutzt.

Typ string
Standardwert -
searchable Pflichtfeld: nein

Setzt Du dieses Attribut auf "true", dann wird bei der Listview die Eigenschaft "durchsuchbar" der Dokumente oder Objekte  (-> Reiter Eigenschaften) beachtet. Es werden dann nur die Dokumente und Objekte gezeigt, die auf durchsuchbar gestellt sind. Wenn das Attribut auf "false" gesetzt wird, wird die Eigenschaft "durchsuchbar" nicht beachtet.

Typ boolean
mögliche Werte true, false
Standardwert true
order Pflichtfeld: nein

Bei diesem Attribut gibst Du den Namen des Feldes an, nach dem die Auflistung sortiert werden soll.

Typ string
Standardwert -
desc Pflichtfeld: nein

Wenn Du den Wert dieses Attributs auf "true" setzt, dann wird die Sortierreihenfolge der Auflistung umgekehrt. Wenn Du den Wert dieses Attributs nicht setzt, dann wird die Sortierreihenfolge beibehalten.

Typ string
mögliche Werte true
Standardwert -
to Pflichtfeld: nein

Bestimmt wie / wohin die Ausgabe erfolgt. Dabei wird der Code, der sonst auf der Seite ausgegeben würde, in exakt derselben Weise an die auszuwählende Variable übergeben. Dies ist eine praktische Alternative zu <we:setVar>, bitte vergleiche und entnimm weitere Details zu den einzelnen möglichen Werten dort.

Erst ab Version 6.1.1: post, get

ab Version 1
Typ string
mögliche Werte screen, request, post, get, global, session, top, self, sessionfield
Standardwert screen
nameto Pflichtfeld: nein

Name der Variablen, in die die Ausgabe erfolgt.

Ab Version 6.3.7 können auch Arrays mit folgender Syntax geschrieben werden werden: <we:xxxx to="global" nameto="meinArray[abc]"/> oder <we:xxxx to="global" nameto="meinArray[]"/> oder <we:xxxx to="global" nameto="meinArray[][def]"/> Wichtig ist hierbei, dass innerhalb der eckigen Klammern keine Hochkommata oder Anführungszeichen genutzt werden!

ab Version 6.1.1
Typ string
Standardwert -

Syntax

<we:listdir id="" index="" field="" dirfield="" searchable="true|false" order="" desc="true" to="screen|request|post|get|global|session|top|self|sessionfield" nameto="">
...
</we:listdir>						

Hilf mit!

Hast Du eine Ergänzung für die Tag-Referenz, dann werde bitte aktiv.
Entweder über einen Eintrag unter qa.webedition.org oder einfach formlos per E-Mail an websites@webedition.org.

Fehler oder Erweiterungswünsche zu webEdition selbst bitte über qa.webedition.org melden.

powered by webEdition CMS