Znacznik Var Drukuj Wyślij znajomemu
Znacznik var umożliwia dołączanie zmiennych do szablonu graficznego. Jest kilka zalet stosowania składni wykorzystującej { nawiasy } jak np. możliwość ustawienia wartości domyślnej lub zmodyfikowanej.
<patTemplate:tmpl name="foo">
  A oto zmienna:
  <patTemplate:var name="myvar" default="my default value"/>
</patTemplate:tmpl>

Atrybuty

Atrybut: name

Nazwa zmiennej

Atrybut: default

Domyślna wartość zmiennej jeśli nie została zdefiniowana

Atrybut: hidden

??

Atrybut: copyFrom

Atrybut ten umożliwia projektantom na dodanie zmiennej do szablonu i skopiowanie wartości z innej zmiennej.

Atrybut: modfier

Może przybrać następujące wartości:

  • htmlentities
  • nl2br
  • wordwrapper
  • dateformat
  • strtoupper
  • strlen
  • strrev
  • HTML_Img
  • Expression
  • Translate (Joomla only)

Przykład:

Konwersja znaków HTML:

<patTemplate:tmpl name="page">
Zastosuj modifier do tekstu:
<patTemplate:var name="sometext" modifier="htmlentities" modifierType="php"/>

Zastosowanie modifier do mulitine:

<patTemplate:var name="multiline" modifier="nl2br" modifierType="php"/>

Zastosowanie modifier do długich tekstów:

<patTemplate:var name="wrap" modifier="wordwrapper"
    modifierType="custom" width="10" cut="no" nl2br="yes"/>

i jeszcze:

<patTemplate:var name="wrap2" modifier="wordwrapper"
    modifierType="custom" width="20" cut="yes" nl2br="yes"/>

Zastosuj modifier do formatu daty :

<patTemplate:var name="birthday" modifier="dateformat" format="%d.%m.%Y"/>

Przykład zastosowania copyFrom:

<patTemplate:tmpl name="page">
<table border="1">
    <tr>
        <th>template</th>
        <th>var</th>
        <th>value</th>
    </tr>
    <tr>
        <td>page</td>
        <td>SOMETEXT</td>
        <td>{SOMETEXT}</td>
    </tr>
    <tr>
        <td>page</td>
        <td>SOMETEXT_PRETTY</td>
        <td><patTemplate:var name="sometext_pretty"
                modifier="nl2br" copyfrom="sometext"/></td>
    </tr>
<patTemplate:tmpl name="nested">
    <tr>
        <td>nested</td>
        <td>SOMETEXT</td>
        <td><patTemplate:var name="sometext" copyfrom="page.sometext"
                modifier="strrev"/></td>
    </tr>
</patTemplate:tmpl>
</table>

Przykład wyrażenia modifier:

<patTemplate:tmpl name="page">
<div>
Zmienna: {VAR}
Czy jest wieksza niz 13?
<!--
    Uzywamy &gt; zamiast >, jesli znacznik ten jest poprawnym znacznikiem XML.
-->
<patTemplate:var name="foo" copyFrom="var" 
modifier="Expression" expression="$self&gt;13" 
true="Yes!" false="Nay!"/>
</div>
</patTemplate:tmpl>

Tłumaczenie zmiennej (tylko w Joomla):

<mos:var name="text" modifier="Translate" />

Modifier w przypadku zmiennej:

Zastosowanie modifier jest naprawdę proste. Wszystko co musisz zrobić to użyć znacznika <patTemplate:var/> zamiast zamykać zmienną w nawiasach klamrowych. Potem możesz wykorzystywać atrybuty modifier aby zastosować odpowiednie wartości.

<patTemplate:tmpl name="page">
      <div>
           <patTemplate:var name="myVar" modifier="nl2br"/>
      </div>
</patTemplate:tmpl>

Uwagi, źródła

Jeżeli masz sugestie odnośnie treści lub chcesz zgłosić poprawki do tego rozdziału, skomentuj go albo umieść wiadomość na forum: Dokumentacja - Propozycje, zmiany, poprawki

Dziękujemy!

Stefan Wajda, Zespół Dokumentacji PCJ

Tłum. Adam Sobkowicz. Na podstawie: help.joomla.org

Zmieniony ( 29.07.2006. )
 
« poprzedni artykuł   następny artykuł »