Quiq::Html::Image - Image-Block in HTML
Quiq::Hash
Ein Objekt der Klasse repräsentiert einen Image-Block. Ein Image-Block stellt ein Bild alleinstehend dar, optional mit Link und Bildunterschrift.
Aufbau eines Image-Blocks:
[<div [class="CLASS"] [id="ID"] [style="STYLE"]>] [<a href="URL">] <img src="URL" width="WIDTH" height="HEIGHT" alt="ALT" /> [<p> <span class="prefix">PREFIX:</span> <span class="caption">CAPTION</span> </p>] [</a>] [</div>]
Die in eckige Klammern eingefassten Bestandteile ([...]) sind optional.
Das Aussehen des Image-Block kann via CSS gestaltet werden. Hier einige Selektoren, mit denen Bestandteile des Konstrukts in CSS angesprochen werden können:
Der gesamte Block.
Der Präfix-Text der Bildunterschrift ("Abbildung N:").
Der Text der Bildunterschrift.
Hierbei ist CLASS der über das Attribut class setzbare CSS-Klassenname.
class
Alternativ-Text, wenn Bild nicht angezeigt wird.
Text der Bildunterschrift.
Präfix-Text der Bildunterschrift, z.B. "Abbildung 1:".
CSS-Klasse des Image-Blocks.
Höhe des Bildes in Pixeln.
Hinterlege Bild mit einem Link auf URL $url.
Die CSS-Id des Image-Blocks.
Der URL des Bildes. Ist kein URL angegeben oder der Wert leer (undef oder Leerstring), wird von der Methode html() kein Image-Block erzeugt, sondern ein Leerstring geliefert.
CSS-Properties des Image-Blocks (d.h. des <div>).
Die Breite des Bildes.
Leerer Block, wenn kein Bild-URL
$class->html($h, src => '', # oder undef );
produziert:
''
Block nur mit Bild
$class->html($h, src => 'illusion.png', width => 100, height => 100, );
<div> <img src="img/illusion.png" width="100" height="100" alt=""> </div>
$e = $class->new(@keyVal);
Liste von Attribut/Wert-Paaren. Die Werte werden auf dem Objekt gesetzt. Siehe Abschnitt ATTRIBUTES.
Image-Block-Objekt (Referenz)
Instantiiere ein Image-Block-Objekt und liefere eine Referenz auf dieses Objekt zurück.
$html = $e->html($h); $html = $class->html($h,@keyVal);
Objekt für die HTML-Generierung, d.h. eine Instanz der Klasse Quiq::Html::Tag.
Siehe Konstruktor.
HTML-Code (String)
Generiere den HTML-Code des Image-Blocks und liefere diesen zurück. Als Klassenmethode gerufen, wird das Objekt intern mit den Attributen @keyVal instantiiert.
1.139
Frank Seitz, http://fseitz.de/
Copyright (C) 2019 Frank Seitz
This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Quiq, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Quiq
CPAN shell
perl -MCPAN -e shell install Quiq
For more information on module installation, please visit the detailed CPAN module installation guide.