<we:img  />

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.

Wir das Attribut "id" nicht gesetzt, muss das Attribut "name" angegeben werden.

ab Version 1.5.2.0
Endtag erforderlich nein
Pflichtattribute

Attribute

name Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert einen eindeutigen Namen an.

Anwendungsfall 1, um im EditMode ein Bild einstellen zu können, muss ein Name gesetzt werden (Pflichtangabe)

Anwendungsfall 2, um ein im WebEdition bereits befindliches Bild nur zu referenzieren darf KEIN Name gesetzt sein (>=WE 9)

ab Version 2.0.0.0
Typ string
Standardwert -
only Pflichtfeld: nein

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

 

ab Version 4.0.0.0
Typ string
mögliche Werte width, height, src, alt, name, parentpath, filename, extension, filesize, id
Standardwert -
id Pflichtfeld: nein

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

ab Version 1.3.0.0
Typ number
Standardwert -
width Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die Breite an.

ab Version 1.3.0.0
Typ number
Standardwert -
height Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die Höhe an.

ab Version 1.3.0.0
Typ number
Standardwert -
border Pflichtfeld: nein

Gib die gewünschte Randstärke an.

ab Version 1.3.0.0
Typ string
Standardwert -
hspace Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert den horizontalen Abstand an.

ab Version 1.3.0.0
Typ string
Standardwert -
vspace Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert den vertikalen Abstand an.

ab Version 1.3.0.0
Typ string
Standardwert -
alt Pflichtfeld: nein

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

ab Version 1.3.0.0
Typ string
Standardwert -
title Pflichtfeld: nein

Gib hier als Attribut den Titel des Bildes an.

ab Version 1.3.0.0
Typ string
Standardwert -
startid Pflichtfeld: nein

Durch dieses Attribut kannst Du festlegen, welches Verzeichnis geöffnet werden soll, sollte noch kein Bild/Flashmovie/Movie ausgewählt worden sein.

ab Version 1.3.0.0
Typ number
mögliche Werte 0
Standardwert -
parentid Pflichtfeld: nein

Durch das Attribut kannst Du das Wurzelverzeichnis festlegen, innerhalb dessen z. B. das Bild/Flashmovie/Movie ausgesucht werden muß. Dieses Verzeichnis kann vom Redakteur nicht verlassen werden.

ab Version 1.3.0.0
Typ number
mögliche Werte 0
Standardwert -
align Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die gewünschte Ausrichtung relativ zu umgebenden Elementen an.

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

Gib hier bitte den Namen einer Miniaturansicht ein, wenn statt des Orginalbilds eine verkleinerte Version ausgegeben werden soll. Gib dafür als Wert des Attributes einen Wert an, den Du in den webEdition-Einstellungen unter Miniaturansicht definiert hast.
Bitte beachte, dass Du hier den Namen der Einstellung angeben musst und keine Größenangabe.

ab Version 1.3.0.0
Typ string
Standardwert -
thumbnailid Pflichtfeld: nein

Gib hier bitte die ID einer Miniaturansicht ein, wenn statt des Orginalbilds eine verkleinerte Version ausgegeben werden soll.

ab Version 1.3.0.0
Typ number
Standardwert -
showcontrol Pflichtfeld: nein

Wenn Du den Wert dieses Attributs auf "true" oder nicht setzt, dann wird der "Grafik auswählen"- und der "Löschen"-Button angezeigt. Wenn Du den Wert dieses Attributs auf "false" setzt, dann werden der "Grafik auswählen"- und der "Löschen"-Button nicht angezeigt.

ab Version 3.0.0.0
Typ boolean
mögliche Werte true, false
Standardwert true
showthumbcontrol Pflichtfeld: nein

Wenn Du den Wert dieses Attributs auf "true" oder nicht setzt, dann wird Auswahl der verfügbaren Miniaturansichten angezeigt.

ab Version 3.0.0.0
Typ boolean
mögliche Werte true, false
Standardwert -
showimage Pflichtfeld: nein
ab Version 1.3.0.0
Typ string
mögliche Werte false
Standardwert -
xml Pflichtfeld: nein
deprecated bis Version 9.0.0 (Barrhorn)

Wenn Du den Wert dieses Attributs auf "true" setzt, dann wird XHTML-konformer Quellcode generiert. Wenn Du als Wert dieses Attributs "false" angibst oder das Attribut nicht setzt, dann wird HTML-konformer Quellcode generiert.

ab Version 1.3.0.0
Typ boolean
mögliche Werte true, false
Standardwert false
showinputs Pflichtfeld: nein

Wenn Du den Wert dieses Attributs auf "true" oder nicht setzt, dann werden Eingabefelder für "Alt-Text" und "Titel" angezeigt. Wenn Du den Wert dieses Attributs auf "false" setzt, 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 Du bei der Grafik direkt eingetragen hast.

ab Version 1.3.0.0
Typ boolean
mögliche Werte true, false
Standardwert true
sizingrel 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.

ab Version 6.1.0.0
Typ float
Standardwert 1.0
sizingbase Pflichtfeld: nein
Basiswert für das Attribut sizingrel.
ab Version 6.1.0.0
Typ number
Standardwert 16
sizingstyle 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.

ab Version 6.1.0.0
Typ string
Standardwert -
to 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 vergleiche und entnimm weitere Details zu den einzelnen möglichen Werten dort.

Ab webEdition 6.1.0.2: post, get

Ab webEdition 9.0.8: local: Erlaubt den Wert einer lokalen Variable zuzuordnen und dann im Tag attribut="$name" zu nutzen.

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

Name der Variable, in die die Ausgabe erfolgt.

Ab webEdition 6.3.7 können auch Arrays mit folgender Syntax geschrieben werden werden:

  • <we:xxxx to="global" nameto="meinArray[abc]"/> oder
  • <we:xxxx to="global" nameto="meinArray[]"/> oder
  • <we:xxxx to="global" nameto="meinArray[][def]"/>.

Wichtig ist hierbei, dass innerhalb der eckigen Klammern keine Hochkommata oder Anführungszeichen genutzt werden!

ab Version 6.1.0.0
Typ string
Standardwert -
pass_* Pflichtfeld: nein

Für das * - also nach dem "_" (Unterstrich) - kann ein beliebiger Wert (HTML-Attribut) vergeben werden. Dieses wird dann so an die Ausgabe weritergegeben.

Zum Beispiel kann man dadurch einem Formular eine ID verpasst werden. Denn das Attribut "id" kann ja nicht verwendet werden, da dieses schon ein webEdition-Attribut ist. In einem solchen Fall kann man "pass_id" verwenden.

Dieses Attribut gibt es übrigens bei allen Tags die eine Ausgabe produzieren.

ab Version 3.2.0.0
Typ string
Standardwert -

Syntax

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

Beispiele

Beispiel #1 - Bild beim Bearbeiten verkleinert darstellen

In diesem Beispiel wird das Bild beim Bearbeiten des Dokuments durch den Redakteur verkleinert dargestellt. Auf der Webseite wird die Orginalgröße verwendet. Bitte beachten Sie, dass "200*150" der Name einer Minituransicht ist und keine direkte Größenangabe darstellt. Code
<we:ifEditmode doc="self">
  <we:img thumbnail="200*150" name="example" />
<we:else />
  <we:img name="example" />
</we:ifEditmode>

Hilf mit!

Hast Du eine Ergänzung für die Tag-Referenz, dann werde 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.

powered by webEdition CMS