Die Common-Controls Tag Bibliothek

<util:imagemap>

Dient zur Deklaration einer ImageMap innerhalb einer JSP-Seite. Über eine ImageMap können einzelne Images anhand von regulären Ausdrücken ausgewählt werden. Die ImageMap wird im HTTP-Request unter dem angegebenen Namen abgelegt.

Achtung: Die Suche nach dem passenden Mapping erfolgt in Deklarationsreihenfolge - also von oben nach unten!

Viele Anzeigeklassen des Frameworks arbeiten mit ImageMaps.


Body content: JSP
Tag class: ImageMapTag
 

[ Syntax ]

Standard Syntax
<util:imagemap
name = "String"
[ base = "Verzeichnisname oder Ressourcenschlüssel" ]
[ runat = "{server | client | auto}" ]
>
...Body Content...

</util:imagemap>
 

[ Attribute ]

AttributTypBeschreibungPflichtRTExp
baseVerzeichnisname oder Ressourcenschlüssel Setzt das Basisverzeichnis für eine Ressource. Dieses wird dem eigentlichen Ressourcennamen vorangestellt. Das base Attribut kann wegen des Lokalisierungsmechanismus des Frameworks auch als Schlüssel der ApplicationProperties.properties Datei angegeben werden.  
nameString Legt den Namen fest, unter welchem die Imagmap im HTTP-Request abgelegt wird.
runatRunAt Dieses Attribut gibt an, ob für das Kontrollelement JavaScript verwendet werden soll, oder ob das Kontrollelement ausschließlich mit Server Roundtrips arbeiten soll.
  • server = Alle Kontrollelement Aktionen führen zu einem Server Roundtrip und werden auf dem Server bearbeitet.
  • client = Kontrollelement Aktionen werden direkt im Browser des Benutzers durchgeführt. Es hängt von der verwendeten Painter Factory und dem konkreten Kontrollelement Painter ab, wie weit die Unterstützung für Clientside Scripting geht.
  • auto = Das Framework wählt basierend auf der JavaScript Aktivierung des Anwender Browsers den Modus "client" bei aktiviertem JavaScript und "server" bei deaktiviertem JavaScript (siehe BrowserInfo).
 

[ Beispiel ]

Erzeugt eine Imagemap mit 4 Image-Zuordnungen und legt diese unter dem Namen im_product im HTTP-Request ab.


<%@ taglib uri="http://www.common-controls.com/cc/tags-util"   prefix="util" %>

<util:imagemap  name="im_product">
    <util:imagemapping  rule="group.open"    src="images/imgBoxOpen.gif"    width="16"  height="16"/>
    <util:imagemapping  rule="group.closed"  src="images/imgBoxClosed.gif"  width="16"  height="16"/>
    <util:imagemapping  rule="product"       src="images/imgItem.gif"       width="16"  height="16"/>
    <util:imagemapping  rule="variant"       src="images/imgItems.gif"      width="16"  height="16"/>
</util:imagemap>