Chapter 4. Společné atributy

Mnoho z TXP tagů může mít atributy, které jsou podobně jako běžné XHTML atributy popsány v jejich syntaxi. Každý tag může své vlastní atributy.

Existuje několik atributů které se mohou použít u značného množství TXP tagů při dodržení vždy stejného významu. Kvůli tomuto a za účelem předejítí nadbytečnosti této příručky, jsou v následujícím textu popsány společně.

Toto ovšem neznamená, že můžete užívat tyto atributy se všemi TXP tagy, ale jen u těch, které je mají uvedené v popisu atributů.

Všimněte si, že hodnoty všech atributů (i číselné) musí být utzavřeny v uvozovkách.

Společné atributy - přehled

  1. limit

    Mnoho TXP tagů je určeno pro nějaký druh seznamů: seznamy linků, článků, komentářů, .... Atribut limit vám umožní specifikovat maximální počet položek v jednom seznamu . Hodnota musí být číslo.

    Tak například můžete nastavit max množství článků zobrazených na vaší standardní stránce pomocí tagu:

    <txp:article limit="5" />
  2. label

    Někdy potřebujete přidat nějaký "label" k TXP prvku jako, například, popup menu, ( popup menu je XHTML selektor, který se nachází, v pravém sloupci TXP standardní stránky a slouží k tomu aby návštěvníci vaší stránky měli nějaký rychlý způsob, jak něco najít a přejít do jakékoliv části vašich stránek).

    Pro přidání vašeho uživatelského labelu k elementu stačí jen specifikovat label jako hodnotu pro atribut label příslušného tagu. Například:

    <txp:popup label="Vyber sekci stránek" type="s" />
  3. wraptag

    Tento atribut nabízí možnost umístit obsah TXP tagu uvnitř XHTML tagu podle vaší volby, bez potřeby nějakého dalšího TXP tagu.

    Proč?, protože používáním tohoto atributu zajistíte, že jestliže TXP tag nic nezobrazí, nebudete mít v našem vygenerovaném dokumentu prázdné XHTML elementy. Příklad: chcete umístit náš předchozí příklad uvnitř tagu <p></p>:

    <txp:popup label="Browse Site Section" type="s" wraptag="p" />
    

    Důležité: Všimněte si, že předáváme hodnotu atributu wraptag bez < a > znaků !!!.

  4. break

    Pokud použijete TXP atribut break, dáváte TXP informaci jaký tag XHTML bude použit po každém seznamu položky.

    Pokud chceme napsat validní XHTML netříděný seznam, můžete využít právě výše uvedných dvou atributů. Vzniká tedy otázka: Jak mohu použít wraptag a break pro generování netříděného seznamu?.

    Naštěstí Dean (autor sytému TXP “- poznámka překladatele”) to vymyslel před námi. Stačí přidat do TXP tagu výpisu atributy break="<li>" wraptag="ul" a jakýmsi TXP kouzlem to samo udělá krásné XHTML seznamy!