bx:bild
Das Tag bild fügt ein Bild aus der Bildergalerie in das Dokument ein und lässt vielfältige Möglichkeiten zur Formatierung. Falls dasselbe Bild mehrmals verwendet werden soll, kann { titel} mehrmals verwendet werden mit z.B. verschiedenen Größenangaben.
Dieses Tag kann sich in der Verwaltung darstellen.
Bild anzeigen mit Größenangabe und Ausrichtung
<bx:bild.{titel} [width="{n}"] [height="{n}"] [align="(left | right | leftright | rightleft)"] [alt="{text}"] [comment={komentar}] />
| width, height | Breiten- bzw Höhenangabe in Pixel; Bilder, die kleiner sind als diese Größenangaben werden jedoch nicht vergrößert. Ist keine Höhe und Breite angegeben, wird das Bild in Originalgröße dargestellt. |
|---|---|
| cover | nimmt die größere Angabe, z.B. bei Querformat wird die Höhe, bei Hochformat die Breite genommen (ab V 2.6.3, ansonsten bei 2.6.2 reinkopieren) |
| cover="crop" | Originalbild wird abgeschnitten und auch so gespeichert |
| align | links- bzw. rechtsseitige Ausrichtung; leftright/rightleft: die Bilder werden abwechselnd ausgerichtet, beginnend links bzw rechts |
Beispiele
einfache Anzeige mit Alt-Angabe
<bx:bild.Seitenbild width="700" height="150" alt="Seitenbild dieser Seite" />
Anzeige mit Kommentar in der Verwaltung
<bx:bild.Seitenbild width="200" height="300" align="right" comment="nichts ausgewählt: Text zieht sich über die gesamte Breite" />
Ausgabeart festlegen
<bx:bild.{titel} [type="(path | url | origwidth | origheight | title | author | alt | calcwidth | calcheight | id | inline)"] />
| path / url | es wird nur der lokale Pfad bzw die URL zum Bild ausgegeben (z.B. Angabe im img-tag oder bei Wechsel der Grafik durch JavaScript) |
|---|---|
| origwidth / origheight | schreibt nur die Originalbreite oder -höhe (z.B. für Popup-Fenster) |
| title | der ursprüngliche Dateiname (gespeichert direkt in der Bildergalerie beim Bild) |
| author | Autor, falls keiner angegeben "null" (gespeichert direkt in der Bildergalerie beim Bild) |
| alt | der Alternativtext (gespeichert direkt in der Bildergalerie beim Bild) |
| calcwidth / calcheight | die berechnete Größe (unter Beachtung von width und height) wird ausgegeben |
| empty | Abfrage, ob ein Bild verknüpft wurde (ab v 2.7.0), not kehrt die Bedingung um |
| id | ID in der Bildergalerie (ab v 2.6.2) |
| inline | erzeugt img-Tag mit Binärdaten in src (ab 2.6.1), sinnvoll bei Newsletter, da steht das Bild direkt in der Seite, also nicht als Link oder Anhang |
| base64data | Tagerweiterung für vcf (Outlook-Visitenkarte) mit Foto ab v2.6.6 |
Beispiele
Anzeige mit img-tag, Angaben kommen alle aus der Bildergalerie
<img src="<bx:bild.Seitenbild width="200" height="300" type="url"/>" alt="<bx:bild.Seitenbild type="alt"/>"
title="<bx:bild.Seitenbild type="title"/>, Autor:<bx:bild.Seitenbild type="author"/>" >
Weitere Angaben
<bx:bild.{titel} [hspace="{n}"] [vspace="{n}"] [kategorie="{kat}"] [force] [nogifshrink] [border="{n}"] [noborder] />
| vspace, hspace | Vertikal- bzw. Horizontalabstand einstellen (in Pixel) |
| nogifshrink | falls das Bild ein GIF ist und es nicht automatisch verkleinert werden soll, Animationen bleiben so erhalten |
| kat, force | es kann der Name einer Kategorie der Bildergalerie angegeben werden, aus der das Bild gewählt werden kann. Wenn zusätzlich noch force gesetzt ist, kann die Kategorie in der Verwaltung nicht gewechselt werden. |
| border, noborder | Einstellen der Rahmenbreite bzw. Rahmen abstellen |