<patTemplate:tmpl>
Pat jest moją najlepszą przyjaciółką.
</patTemplate>
Ten znacznik wskazuje początek szablonu graficznego. Cały tekst znajdujący się poniżej tego znacznika zostanie dołączony do szablonu graficznego aż do końcowego znacznika zamykającego.
Atrybuty
Następujące atrybuty są możliwe do wykorzystania:
name (opcjonalnie ale zwykle wprowadzany)
Ten atrybut wymienia nazwę szablonu graficznego. Nazwa musi być unikalna jeśli będzie wykorzystywana jako adres do szablonu graficznego z poziomu funkcji API. Jeśli atrybut nazwa zostanie opuszczona unikalna nazwa zostanie wygenerowana dla szablonu graficznego.
<patTemplate:tmpl name="body">
To jest moja strona.
</patTemplate:tmpl>>
type (opcjonalnie)
Ten atrybut definiuje typ szablonu graficznego i może przyjmować następujące wartości:
Standard
(jest to wartość domyślna jeśli typ zostanie pomięty)
<patTemplate:tmpl name="body" type="standard">
To jest szablon.
</patTemplate:tmpl>
OddEven
OddEven szata graficzna musi mieć dwie sub-szablony graficzne z warunkami dla opcji parzysty-nieparzysty. Te sub-szablony graficzne są używane naprzemiennie gdy szablon jest przeładowywany.
<patTemplate:tmpl name="row" type="oddeven">
<patTemplate:sub condition="__odd">
<div style="background-color:#cccccc">{VALUE}</div>
</patTemplate:sub>
<patTemplate:sub condition="__even">
<div style="background-color:#ffffff">{VALUE}</div>
</patTemplate:sub>
</patTemplate:tmpl>
Modulo
Szablon modulo pozwala ci definiować dowolną ilość sub-szablonów dla zmieniających się list. Jest bardzo podobny do szablonu OddEven
<patTemplate:tmpl name="row" type="modulo" modulo="3">
<patTemplate:sub condition="0">
<div style="background-color:red">{VALUE}</div>
</patTemplate:sub>
<patTemplate:sub condition="1">
<div style="background-color:blue">{VALUE}>/div>
</patTemplate:sub>
<patTemplate:sub condition="2">
<div style="background-color:green">{VALUE}>/div>
</patTemplate:sub>
</patTemplate:tmpl>
Dwie specjalne zmienne systemowe dla szablonu typu modulo. Są to:
PAT_MODULO
Jest to wartość dla bieżącego sub-szablonu. W przykładzie powyżej przyjmuje cyklicznie wartości 1,2 i 0.
PAT_MODULO_REP
Jest to liczba zapętleń albo ile razy cały szablon może zostać powtórzone, zaczynając od jeden.
Condition
Warunek może zawierać tak wiele sub-szablonów jak chcesz. Ten typ emuluje przełącznik stanu w PHP.
SimpleCondition
SimpleCondition może zdefiniować kilka zmiennych, które muszą być ustawione aby zagwarantować to, że szablon jest wyświetlany. Nie zawierają żadnych sub-szablonów. Jeśli wszystkie zmienne są ustawione szablon jest widoczny w przeciwnym wypadku jest ukryty.
Uwaga: musisz użyć atrybutu requiredvars aby zdefiniować zmienne, które muszą być ustawione, jako listę zmiennych oddzielonych przecinkami.
addsystemvars
Atrybut pozwalający ci dodać specjalne zmienne systemowe, jak liczba powtórnego ładowania sablonu. Atrybut może przyjmować następujące wartości:
- boolean - do wykorzystania, gdzie wartość boolean zmiennej systemowej może być wykorzystana, wtedy mamy 'true' lub 'false'
- integer - do wykorzystania, gdzie liczbowy odpowiednik wartości boolean może być wykorzystany, wtedy mamy 0 jako false i 1 jako true
- inny tekst - w sytuacji gdy wskazane jest aby zmienne systemowe zwracały dowolny tekst jeśli true lub pusty ciąg znaków jeśli false
Przykład:
<patTemplate:tmpl name="tmpl-1" addSystemVars="boolean">
<strong>System-variables:</strong>
PAT_LOOPS : {PAT_LOOPS}
PAT_IS_FIRST : {PAT_IS_FIRST}
PAT_IS_LAST : {PAT_IS_LAST}
PAT_IS_ODD : {PAT_IS_ODD}
PAT_IS_EVEN : {PAT_IS_EVEN}
PATTEMPLATE_VERSION : {PATTEMPLATE_VERSION}
</patTemplate:tmpl>
autoclear
Jeśli autoclear jest ustawiony na tak szablon będzie za każdym razem ładowany ponownie kiedy jest wyświetlony.
autoload
Pozwoli ci dynamicznie dołączać szablon.
Przykład
$tmpl->readTemplatesFromInput( 'example.tmpl' );
$tmpl->setAttribute( 'main', 'src', 'example_include.tmpl' );
$tmpl->displayParsedTemplate();
<mos:tmpl name="main" src="dynamic" autoload="off" parse="on" />
conditionvar (wymagane dla szablonów typu condition)
Ustawia nazwę zmiennej, która będzie używana do emulowania przełącznika stanu.
Przykład:
conditionvar="NAME"
Sprawdzanie zmiennych z innych szablonów
Od wersji 2.4 możliwe jest używanie zmiennej z innego szablony jako zmiennej warunkowej. Aby to zrobić zaimplementowaliśmy składnię z wykorzystaniem 'kropki'. Użyj po prostu
conditionvar="TEMPLATENAME.VARNAME" aby wykorzystać zmienną dowolnego szablonu jako zmienną coditionvar. Ale bądź ostrożny podczas używania zmiennych szablonów, które są powtarzane jako liczba iteracji szablonu.
requiredvars (wymagany dla szablonu simplecondition)
To może być lista zmiennych, które muszą być ustawione aby szablon mógł się wyświetlać. Każda zmienna musi być oddzielona przecinkiem. Jest to bardzo użyteczne gdy chcesz wyświetlać komunikaty błędu kiedy jedna bądź więcej zmiennych nie jest ustawiona. Z wersją 2.4 możesz użyć również składni 'kropki' do sprawdzenia czy zmienne są ustawione w innych szablonach.
Przykład: Example:
requiredvars="NAME,STREET,ZIPCODE"
useglobalas (opcjonalne)
Ten atrybut może być używany dla szablonów graficznych typu "Condition" albo "Simple Condition" po to aby przekazać do patTemplate informację, że zmienne globalne powinny zostać zastosowane gdy zmienne lokalne nie są ustawione.
Atrybut ten nie potrzebuje wartości może być ustawiony jako flaga.
Przykład:
"useglobals="yes" albo po prostu useglobals
loop (opcjonalny)
Wymusza powtarzanie szablonu nawet jeśli nie ma żadnych wartości, które powinny być powtórzone.
Przykład
loop="10"
visibility (opcjonalny)
Visibility może być ustawione albo jako "visible"/widoczny albo "hidden" (ukryty). Jeśli ustawione będzie na hidden szablon nie będzie widoczny. Może być używany do ukrywania bądź wyświetlania komunikatów błędów, jako atrybuty może być zmienione poprzez użycie setAttribute (zobacz dokumenty API)
Przykład:
visibility="hidden"
placeholder (opcjonalnie)
Ten atrybut powinien być stosowany tylko przez zaawansowanych użytkowników
Kiedy umieszczony zostaje szablon w szablonie parser będzie przetwarzał HTML podszablonu i zamieni go na
znacznik (TMPL:templatename) aby zidentyfikować pozycję gdzie podczas wyświetlania podszablon ma zostać wstawiony. Z tym atrybutem możesz wymusić zastosowanie własnego znacznika albo wykluczyć możliwość stosowania takiego znacznika w ogóle (ustaw to jako "none").
Przykład:
placeholder="CONTENT"
parse (opcjonalnie)
Zobacz atrybut src
src (opcjonalnie)
Wykorzystaj zewnętrzny plik jako treść dla danego szablonu. Powinien byś stosowany w połączeniu z atrybutem parse="on|off" aby wskazać parserowi, że zewnętrzn plik również powinien być przetworzony (zbliżone do zewnętrznych encji XML) albo jeśli zawiera zwykły HTML, który powinien zostać dołączony.
unusedvars (opcjonalni)
Ten atrybut informuje parser jak powinny być traktowane zmienne, które nie mają przypisanych wartości. Może mieć jedną z następujących wartości.
- ignore [ignoruj] - pozostaw je tak jakie są
- strip [usuwaj] - usuń je z kodu HTML
- comment [komentuj] - użyj komentarzy HTML aby stały się niewidoczne
- nbsp [] - podmień je na inne (non-breaking space)
- albo każdy inny łańcuch znaków, na kóry powinno być zamienione
varscope (opcjonalnie)
Ten atrybut może być używany do zaimportowania zmiennych z innych szablonów graficznych do tego szablonu. Wyjaśnijmy to tak, powiedzmy, że jest utworzony jeden szablon dla całej strony i dodane są do niego wszystkie zmienne. Kiedy wstawiasz nowy szablon na stronie, zmienne w tym nowym szablonie nie będą brane pod uwagę, dopóki nie zostaną zadeklarowane. I w tym miejscu pomaga atrybut varscope. Należy wstawić po prostu atrybut
varsope="NAMEOFPAGE" w znaczniku tmpl i wszystkie zmienne z pierwszego szablonu będą dostępne w nowym szablonie.
whitespace (opcjonalnie)
Informuje parser jak mają być traktowane puste miejsca (whitespace) (trim, ltrim, rtrim, keep). Pozwala to generować HTML bez żadnych linii łamiących (break line) z szablonu zawierającego takie elementy.
patTemplate 
