Control slouží pro vytváření statických odkazů (pro dynamické odkazy slouží control <je:avar>
). Hodí se jako náhrada HTML tagu <a>
v situacích, kdy adresu není možné uvést absolutně – obvykle kvůli umístění ve virtuálním adresáři na vývojovém serveru – ale ani relativně – např. jsou přepisována URL.
<je:a runat="server" href="/cs/default.aspx" />
Atributy
attributes nepovinný [definovaná syntaxe]
Atribut umožňuje vypisovaný element doplnit libovolnými atributy:
attributes="some-attribute: some value, another-attribute: different value"
Pro hodnoty atributů lze použít interpolace:
attributes="some-attribute: {someVariable.someField}"
Některé znaky je třeba escapovat:Znak , : { } \ " Escape sekvence \, \: \{ \} \\ " class nepovinný [string, interpolace]
Hodnota atributu bude beze změny přenesena do výstupního kódu do atributu
class
.container nepovinný [ID containeru, .prev, .next, .parent]
ID containeru, který určuje kontejnerovou proměnnou controlu (viz Kontejnerování), případně modifikace proměnné (viz Vnitřní pole proměnných).
href povinný [string, interpolace]
URL, na kterou má výsledný odkaz směřovat. URL se doporučuje uvádět absolutně (tj. s počátečním lomítkem) z rootu virtuálního adresáře webu. Případný virtuální adresář je do odkazu automaticky doplněn, taktéž případný jazykový adresář je automaticky přepsán na zvolený jazyk (viz Adresářová struktura webu). V adrese lze použít interpolaci.
idForClient nepovinný [string, interpolace]
Hodnota atributu bude beze změny přenesena do výstupního kódu do atributu
id
.mark nepovinný [definovaná syntaxe]
Atribut slouží k označení vygenerovaného HTML tagu třídou podle aktuální URL nebo pozice na webu, kde se návštěvník nachází. Typicky se používá pro zvýrazňování menu nebo jiných navigačních prvků. Hodnotou atributu může být pouze definovaná syntaxe. Více viz Koncepty/Menu.
mode nepovinný [link, text, sitemap]
Pomocí atributu lze změnit výslednou podobu html kódu. Kromě elementu
<a>
lze tento control použít k zobrazení odkazu, na nějž control směřuje.- link – control vypíše HTML tag
<a>
, URL je vypsána do atributuhref
html <je:a runat="server" href="/cs/page.aspx">toto je odkaz</je:a>
- text – control vypíše URL jako text. URL bude vypsána jako lokální, tj. bez adresy serveru. Control při tomto použití nesmí obalovat žádný obsah
html <je:a runat="server" href="/cs/page.aspx" mode="text" />
- sitemap – control vypíše URL jako text. URL bude vypsána kompletní, tj. včetně adresy serveru a protokolu. Control při tomto použití nesmí obalovat žádný obsah
html <je:a runat="server" href="/cs/page.aspx" mode="sitemap" />
a URL musí být uvedena absolutně z virtuálního adresáře, ve kterém je web umístěn.
- link – control vypíše HTML tag
preserveLangDir nepovinný [true, false]
Nastavením na true lze potlačit u absolutních odkazů úpravu cesty změnou jazykového adresáře. Více podrobností včetně příkladů je uvedeno v kapitole Adresářová struktura webu.
preservePath nepovinný [true, false]
Nastavením na true lze potlačit u absolutních odkazů úpravu cesty doplněním virtuálního adresáře. Více podrobností včetně příkladů je uvedeno v kapitole Adresářová struktura webu.
rel nepovinný [string, interpolace]
Hodnota atributu bude beze změny přenesena do výstupního kódu do atributu
rel
.style nepovinný [string, interpolace]
Hodnota atributu bude beze změny přenesena do výstupního kódu do atributu
style
.target nepovinný [string]
Cílové okno pro odkaz. Hodnota atributu bude beze změny přenesena do výstupního kódu do atributu
target
.title nepovinný [string, interpolace]
Hodnota atributu bude beze změny přenesena do výstupního kódu do atributu
title
.
Lze také použít atributy HTML pro události myši a klávesnice (onclick, ondblclick, onmousedown, onmouseup, onmouseover, onmousemove, onmouseout, onkeypress, onkeydown, onkeyup). Jejich obsah je přímo přepsán do výstupu.
Příklad
<je:a runat="server" href="/cs/default.aspx">Home</a>
Pokud web běží ve virtuální složce na lokálním vývojovém serveru localhost/example
, dostaneme
<a href="/example/cs/default.aspx">Home</a>
Když pak web přesuneme do ostrého provozu na www.example.com
, dostaneme
<a href="/cs/default.aspx">Home</a>