<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
- only
- id
- width
- height
- border
- hspace
- vspace
- alt
- title
- startid
- parentid
- align
- thumbnail
- thumbnailid
- showcontrol
- showthumbcontrol
- showimage
- xml
- showinputs
- sizingrel
- sizingbase
- sizingstyle
- to
- nameto
- pass_*
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 | - |
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 | - |
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 | - |
Bei diesem Attribut gibst Du als Wert die Breite an.
| ab Version | 1.3.0.0 |
| Typ | number |
| Standardwert | - |
Bei diesem Attribut gibst Du als Wert die Höhe an.
| ab Version | 1.3.0.0 |
| Typ | number |
| Standardwert | - |
Gib die gewünschte Randstärke an.
| ab Version | 1.3.0.0 |
| Typ | string |
| Standardwert | - |
Bei diesem Attribut gibst Du als Wert den horizontalen Abstand an.
| ab Version | 1.3.0.0 |
| Typ | string |
| Standardwert | - |
Bei diesem Attribut gibst Du als Wert den vertikalen Abstand an.
| ab Version | 1.3.0.0 |
| Typ | string |
| Standardwert | - |
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 | - |
Gib hier als Attribut den Titel des Bildes an.
| ab Version | 1.3.0.0 |
| Typ | string |
| Standardwert | - |
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 | - |
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 | - |
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 | - |
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 | - |
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 | - |
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 |
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 | - |
| ab Version | 1.3.0.0 |
| Typ | string |
| mögliche Werte | false |
| Standardwert | - |
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 |
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 |
| ab Version | 6.1.0.0 |
| Typ | float |
| Standardwert | 1.0 |
| ab Version | 6.1.0.0 |
| Typ | number |
| Standardwert | 16 |
| ab Version | 6.1.0.0 |
| Typ | string |
| Standardwert | - |
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 |
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 | - |
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
<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.