Image-Map Vorlagen

Das Element "map"

Das Element "map" definiert XSL-Transformationsvorlagen, die genau einmal auf die FamTree XML Exportdatei angewendet werden, um eine grafische Repräsentation des Stammbaums im HTML-Technik, eine sogenannte "Image-Map" zu erzeugen. Im Unterschied zum "global"-Element hat das "map"-Element eine Reihe weiterer Attribute, die für die flexible Erzeugung der Image-Map benötigt werden.

Image-Maps (dt. auch "verweis-sensitive Grafiken") sind eine Standard-HTML-Element. Eine weiterführende Einführung in Image-Maps würde den Rahmen dieser Hilfe-Seiten sprengen. Tutorials und weiterführende Informationen zu Image-Maps finden sich im Internet, z.B. bei SelfHTML http://de.selfhtml.org/html/grafiken/verweis_sensitive.htm

Attribute

• file-extension: Die Dateiendung der erstellten Dateien (im allg. "htm" oder "html").
  
  
• image-format: Das Dateiformat der Grafik, die der Image-Map zugrunde liegen soll. Die unterstützten Grafikformate sind im Kapitel "Einstellungen für Grafik-Export" beschrieben.
  
  
• replace-area: Die in diesem Attribut definierte Zeichenkette wird in der Transformationsvorlage durch den erzeugten map-Inhalt ersetzt.
  Wichtig: Das "map"-Element selbst muss in der Transformationsvorlage vorhanden sein, nur der Inhalt des HTML-Tags "map" wird vollständig von FamTree erzeugt.
  
  
• replace-image-src: Die in diesem Attribut definierte Zeichenkette wird in der Transformationsvorlage durch den Name der erzeugten Grafik-Datei ersetzt.
  
  
• area-href: Dieses Attribut definiert den Verweis (HTML-Seite oder JavaScript-Aufruf), der beim Anklicken einer Person in der Image-Map aufgerufen wird. Die personenspezifische Kennung zum Aufruf (die Personen-ID) wird hierbei über eine Teilzeichenkette angegeben, welche selber wiederum im nächsten Attribut definiert wird.
  
  
• area-href-replace-id: Dieses Attribut definiert die Teilzeichenkette, die im Attribut area-href personenspezifisch durch die eindeutige ID ersetzt wird.
  
  

Unterelemente

• file

  Das Unterelement "file" kann theoretisch beliebig häufig vorkommen, ist aber im "map"-Element üblicherweise nur einmal vorhanden. Es hat keinen eigenen Wert und keine weiteren Unterelementem, sondern nur ein Pflicht-Attribut:

  • name: Der Name der XSL-Transformationsvorlage relativ zur Vorlagen-Beschreibungsdatei. Der Dateiname im erzeugten HTML-Projekt ergibt sich aus dem XSL-Dateinamen und der im global-Attribut file-extension angegebenen Endung.
    
    

Beispiel

<map file-extension="html"
     image-format="png"
     replace-area="#MAP-AREA#"
     replace-image-src="#IMAGE-SRC#"
     area-href="javascript:show(#ID#);"
     area-href-replace-id="#ID#">
  <file name="imagemap/map.xsl"/>
</map>

Mit dem dazu korrespondierenden Abschnitt in der XSL-Transformationsvorlage:

<map name="famtree">
  #MAP-AREA#
</map>
<img src="#IMAGE-SRC#" usemap="#famtree" border="0" />

wird im Unterordner "imagemap" die Grafik-Datei "map.png" und die Datei "map.html" mit folgendem Inhalt (Ausschnitt) generiert:

<map name="famtree">
  <area shape="rect" coords="120,595,190,643" href="javascript:show(1);">
  <area shape="rect" coords="950,105,1020,153" href="javascript:show(2);">
  <area shape="rect" coords="880,635,950,683" href="javascript:show(3);">
</map>
<img src="map.png" usemap="#famtree" border="0">