Quiq::Html::Verbatim - Verbatim-Block in HTML
Quiq::Hash
Ein Objekt der Klasse repräsentiert einen Verbatim-Block in HTML. Ein Verbatim-Block gibt einen Text TEXT in Festbreitenschrift mit allen Leerzeichen und Zeilenumbrüchen identisch wieder. Innerhalb von TEXT ist HTML erlaubt. Der Verbatim-Block kann mit Zeilennummern ausgestattet werden. In dem Fall wird das HTML-Konstrukt um eine <table> ergänzt und dadurch komplexer.
Aufbau eines Verbatim-Blocks ohne Zeilennummern:
<div class="CLASS" [id="ID"] [style="STYLE"]> <pre>TEXT</pre> </div>
Aufbau eines Verbatim-Blocks mit Zeilennummern:
<div class="CLASS" [id="ID"] [style="STYLE"]> <table> <tr> <td class="ln"> <pre>ZEILENNUMMERN</pre> </td> <td class="margin"></td> <td class="text"> <pre>TEXT</pre> </td> </tr> </table> </div>
Die in eckige Klammern eingefassten Bestandteile ([...]) sind optional.
Das umgebende div klammert das gesamte Konstrukt und ermöglicht auch im Falle von Zeilennummer, dass der Hintergrund des Blocks über die gesamte Breite der Seite farbig hinterlegt werden kann.
div
Das Aussehen des Verbatim-Block kann via CSS gestaltet werden. Hier die Selektoren, mit denen einzelne Bestandteile des Konstrukts in CSS angesprochen werden können:
Der gesamte Block.
Der Verbatim-Text im Falle einer Darstellung ohne Zeilennummern.
Die Tabelle im Falle von Zeilennummern.
Die Zeilennummern-Spalte.
Die Trenn-Spalte zwischen Zeilennummer- und Text-Spalte.
Die Text-Spalte.
Hierbei ist CLASS der über das Attribut class änderbare CSS-Klassenname. Default-Klassenname ist 'verbatim'.
class
CSS-Klasse des Verbatim-Blocks.
Die CSS-Id des Verbatim-Blocks.
Wenn ungleich 0, wird jeder Zeile eine Zeilennummer vorangestellt, beginnend Zeilennummer $n.
CSS-Properties des Verbatim-Blocks (<div>).
Der dargestellte Text. Ist $text leer (undef oder Leerstring), wird kein Verbatim-Block erzeugt, d.h. die Methode $obj->html() liefert einen Leerstring.
undef
$e = $class->new(@keyVal);
Liste von Attribut/Wert-Paaren. Die Werte werden auf dem Objekt gesetzt. Siehe Abschnitt ATTRIBUTES.
Verbatim-Abschnitts-Objekt (Referenz)
Instantiiere ein Verbatim-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 Verbatim-Blocks und liefere diesen zurück. Als Klassenmethode gerufen, wird das Objekt intern mit den Attributen @keyVal instantiiert.
1.165
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.