vtPortions

(Basic, Pro, Master ab 1.3)

Wird durch eine Navigationshilfe ersetzt, die das Blättern durch portionierte Listen ermöglicht.

Verwendung

{{vtPortions}}

{{vtPortions: %Klasse}}

{{vtPortions:
    -class="%Klasse", 
    -prev="%Zurück-Zeichen", 
    -next="%Weiter-Zeichen", 
    -sep="%Trennzeichen", 
    -omit="%Auslassungszeichen", 
    -span="%Ausdehnung"
}}

%Klasse

(optional) CSS-Klasse, die den erzeugten Ankerelementen zugewiesen werden soll.

%Ausdehnung

(optional) Maximalzahl an Elementen, die rechts und links vom aktuellen Element dargestellt werden sollen. Bei fehlender Angabe sind stets alle Elemente sichtbar.

%Zurück-Zeichen

(optional) Zeichenkette, die als Beschriftung für den "Zurück"-Link verwendet werden soll. Bei fehlender Angabe wird << verwendet.

%Weiter-Zeichen

(optional) Zeichenkette, die als Beschriftung für den "Weiter"-Link verwendet werden soll. Bei fehlender Angabe wird >> verwendet.

%Trennzeichen

(optional) Zeichenkette, die zwischen den einzelnen Ankerelementen eingefügt werden soll. Bei fehlender Angabe wird ein Leerzeichen verwendet.

%Auslassungszeichen

(optional) Zeichenkette, die an den Stellen eingefügt werden soll, an denen Ankerelemente ausgelassen werden (nur relevant, wenn %Ausdehnung > 0). Bei fehlender Angabe wird ... verwendet.

Hinweise

Der vtPortions-Platzhalter ist nur für Templates gedacht, in denen eine vtLoop-Anweisung vorkommt, bei der die Zahl der Durchläufe mittels -size-Parameter begrenzt ist. In diesem Fall gibt vtPortions eine Navigationshilfe aus, mit der ein Leser durch die einzelnen "Portionen" der Liste blättern kann. Wenn die Gesamtlänge der Liste kleiner ist als die angegebene Portionsgröße, gibt vtPortions nichts aus.

Falls sich vtPortions auf eine vtLoop-Anweisungen bezieht, die zu einer Selektion gehört, muss der Platzhalter innerhalb des betreffenden vtSelect-Blocks stehen.

Beachten Sie, dass vtPortions im Template auf jeden Fall hinter der vtEndLoop-Anweisung stehen muss. Sollen die Hyperlinks auf besondere Weise formatiert werden, können Sie durch Angabe des zusätzlichen Parameters eine beliebige CSS-Klasse zuordnen. Jedes <a>-Element erhält dann ein zusätzliches class-Attribut, dessen Wert dem Namen der angegebenen Klasse entspricht.

Beispiel

<p><b>Liste</b></p>
<ul>
    <!--{{vtLoop: -size="5"}}-->
        <li><a href="{{vtLink}}">{{vtName}}</a></li>
    <!--{{vtEndLoop}}-->
</ul>
<p>{{vtPortions}}</p>

Siehe auch

• vtLoop