Dieses Tag dient dazu, eine Grafik in den Inhalt eines Dokumentes einzubauen. Im Bearbeitungsmodus eines Dokumentes ist unter der Grafik ein Button "edit" sichtbar. Durch Anklicken des Buttons öffnet sich der Dateimanager, aus dem man eine Grafik auswählen oder neu anlegen kann. Wenn die Attribute "width", "height", "border", "hspace", "vspace", "alt" oder "align" gesetzt werden, dann werden diese Einstellungen für die Grafik verwendet, ansonsten gelten die Einstellungen, welche bei der Grafik gemacht wurden. Wenn das Attribut id gesetzt ist, dann wird die Grafik mit dieser ID benutzt, falls noch keine andere Grafik ausgewählt wurde. Das Attribut showimage ermöglicht es, das Bild im Bearbeiten-Modus nicht anzeigen zu lassen. Mit showinputs lassen sich die Eingabefelder für title und alt-text deaktivieren.

• name

  Typ: string | Standardwert: - | Pflichtfeld: ja

  Bei diesem Attribut geben Sie als Wert einen eindeutigen Namen an.
• only

  Typ: string | mögliche Werte: width, height, src, alt | Standardwert: - | Pflichtfeld: nein

  Gibt einzelne Parameter eines Bildes aus:
  Zu einem Bild werden neben dem Dateinamen weitere Informationen gespeichert, welche Sie auf der Eigenschaften-Seite des jeweiligen Bilds bearbeiten können. Dazu gehören u.a. Daten wie die Breite, Höhe, etc… Mit dem Attribut "only" können Sie einzelne dieser Werte ausgeben lassen.
  
• id

  Typ: number | Standardwert: - | Pflichtfeld: nein

  Bei diesem Attribut geben Sie als Wert die ID eines Bildes an, welches vorausgewählt sein soll (wird angezeigt, wenn kein Bild ausgewählt wurde).
  
• width

  Typ: number | Standardwert: - | Pflichtfeld: nein

  Bei diesem Attribut geben Sie als Wert die Breite an.
  
• height

  Typ: number | Standardwert: - | Pflichtfeld: nein

  Bei diesem Attribut geben Sie als Wert die Höhe an.
  
• border

  Typ: string | Standardwert: - | Pflichtfeld: nein

  Geben Sie die gewünschte Randstärke an.
  
• hspace

  Typ: string | Standardwert: - | Pflichtfeld: nein

  Bei diesem Attribut geben Sie als Wert den horizontalen Abstand an.
  
• vspace

  Typ: string | Standardwert: - | Pflichtfeld: nein

  Bei diesem Attribut geben Sie als Wert den vertikalen Abstand an.
• alt

  Typ: string | Standardwert: - | Pflichtfeld: nein

  Bei diesem Attribut geben Sie als Wert den Text an, welcher auf der fertig generierten Seite als Text-Wert des alt-Attributs des HTML-img-Tags eingesetzt werden soll.
  
• title

  Typ: string | Standardwert: - | Pflichtfeld: nein

  Geben Sie hier als Attribut den Titel des Bildes an.
  
• startid

  ab Version: 0. | Typ: number | mögliche Werte: 0 | Standardwert: - | Pflichtfeld: nein

  Durch dieses Attribut können Sie festlegen, welches Verzeichnis geöffnet werden soll, sollte noch kein Bild/Flashmovie/Movie ausgewählt worden sein.
  
• parentid

  ab Version: 6.0.0.6 | Typ: number | mögliche Werte: 0 | Standardwert: - | Pflichtfeld: nein

  Durch das Attribut können Sie das Wurzelverzeichnis festlegen, innerhalb dessen das Bild/Flashmovie/Movie ausgesucht werden muß. Dieses Verzeichnis kann vom Redakteur nicht verlassen werden.
  
• align

  Typ: string | mögliche Werte: left, right, top, bottom, absmiddle, middle, texttop, baseline, absbottom | Standardwert: - | Pflichtfeld: nein

  Bei diesem Attribut geben Sie als Wert die gewünschte Ausrichtung relativ zu umgebenden Elementen an.
  
• thumbnail

  Typ: string | Standardwert: - | Pflichtfeld: nein

  Geben Sie hier bitte den Namen einer Miniaturansicht ein, wenn statt des Orginalbilds eine verkleinerte Version ausgegeben werden soll. Geben Sie dafür als Wert des Attributes einen Wert an, den Sie in den webEdition Einstellungen unter Miniaturansicht definiert haben.
  Bitte beachten Sie, dass Sie hier den Namen der Einstellung angeben müssen und keine Größenangabe.
  
• showcontrol

  Typ: boolean | mögliche Werte: true, false | Standardwert: true | Pflichtfeld: nein

  Wenn Sie den Wert dieses Attributs auf "true" oder das Attribut nicht setzen, dann wird der "Grafik auswählen" und der "Löschen" Button angezeigt. Wenn Sie den Wert dieses Attributs auf "false" setzen, dann werden der "Grafik auswählen" und der "Löschen" Button nicht angezeigt.
  
• showimage

  Typ: string | mögliche Werte: false | Standardwert: - | Pflichtfeld: nein

• xml

  Typ: boolean | mögliche Werte: true, false | Standardwert: false | Pflichtfeld: nein

  Wenn Sie den Wert dieses Attributs auf "true" setzen, dann wird XHTML-konformer Quellcode generiert. Wenn Sie als Wert dieses Attributs "false" angeben oder das Attribut nicht setzen, dann wird HTML-konformer Quellcode generiert.
  
• showinputs

  Typ: boolean | mögliche Werte: true, false | Standardwert: true | Pflichtfeld: nein

  Wenn Sie den Wert dieses Attributs auf "true" oder das Attribut nicht setzen, dann werden Eingabefelder für "Alt-Text" und "Titel" angezeigt. Wenn Sie den Wert dieses Attributs auf "false" setzen, dann werden die Eingabefelder für "Alt-Text" und "Titel" nicht angezeigt. In diesem Fall werden die Angaben für das alt- und/oder title-Attribut übernommen, die Sie bei der Grafik direkt eingetragen haben.
  
• cachelifetime

  Typ: number | Standardwert: 0 | Pflichtfeld: nein

  Mit diesem Attribut definieren Sie die Gültigkeit des Caches in Sekunden für diesen we-Tag. Dieses Attribut wird nur verwendet, wenn in der Vorlage "we-Tag-Cache" bzw. "kein Cache" eingestellt ist.
• sizingrel

  ab Version: 0.0 | Typ: float | Standardwert: 1.0 | Pflichtfeld: nein

  Mit diesem Attribut läßt sich eine Flashdatei skalieren, z.B. mit sizingrel="0.5". Basis ist die im Attribut sizingbase gemachte Angabe. Die klassischen width und height Attribute des HTML object-Tags werden in diesem Fall nicht ausgegeben. Damit sollten barrierefreie Sites einfacher zu realisieren sein.
  
  
• sizingbase

  ab Version: 0.0 | Typ: number | Standardwert: 16 | Pflichtfeld: nein

  Basiswert für das Attribut sizingrel.
  
• sizingstyle

  ab Version: 0.0 | Typ: string | Standardwert: - | Pflichtfeld: nein

  Mit dem Attribut sizingstyle="none/em/ex/px/%" kann eine (skalierte) style-Angabe in der entsprechenden Einheit erzeugt werden, die Basis für Umrechnungen mit dem Attribut sizingbase (standard: 16) umgestellt werden.
  
  
• to

  ab Version: 1 | Typ: string | mögliche Werte: screen, request, post, get, global, session, top, self, sessionfield | Standardwert: screen | Pflichtfeld: nein

  Bestimmt wie / wohin die Ausgabe erfolgt. Dabei wird der Code, der sonst auf der Seite ausgegeben würde, in exakt derselben Weise an die auszuwählende Variable übergeben. Dies ist eine praktische Alternative zu <we:setVar>, bitte vergleichen Sie und entnehmen weitere Details zu den einzelnen möglichen Werten dort.
  
  Erst ab Version 6.1.1: post, get
  
• nameto

  ab Version: 6.1.1 | Typ: string | Standardwert: - | Pflichtfeld: nein

  Name der Variable in die die Ausgabe erfolgt.
  

<we:img name="" only="width|height|src|alt" id="" width="" height="" border="" hspace="" vspace="" alt="" title="" startid="0" parentid="0" align="left|right|top|bottom|absmiddle|middle|texttop|baseline|absbottom" thumbnail="" showcontrol="true|false" showimage="false" xml="true|false" showinputs="true|false" cachelifetime="" sizingrel="" sizingbase="" sizingstyle="" to="screen|request|post|get|global|session|top|self|sessionfield" nameto=""/>

Haben Sie eine Ergänzung für die Tag-Referenz, dann werden Sie bitte aktiv.
Entweder über einen Eintrag unter qa.webedition.org oder einfach formlos per E-Mail an websites@webedition.org.

Fehler oder Erweiterungswünsche zu webEdition selbst bitte über qa.webedition.org melden.