bx:barcode

Mit dem Tag barcode können verschiedene 1D und 2D-Codes erzeugt werden (Beispiele siehe unten). Ein Check auf Fehler ist mit bx:if möglich. Die Größe ist frei wählbar. Das erzeugte Format ist PNG (ggf. mit Transparenz)

Funktionen:

Allgemeine Syntax

<bx:barcode.qr width="250" height="250" [type="path"] [rotate="90"]> Inhalt </bx:barcode.qr>

Parameter für alle Typen

width und height	geben die Größe des Barcodes anein weißer Rand ist teilweise automatisch enthalten und kann bei manchen Typen auch beeinflusst werden
type	image: (Standard) es wird ein img-Tag erzeugt, Parameter wie style oder class im Barcode-Tag werden in das img-Tag übernommenpath: es wird nur der Pfad zum Bild ab "/" zurückgegeben (ohne Host, falls Haupthost-Haken im Projekt nicht gesetzt wurde)url: es wird eine komplette URL zum Bild zurückgegeben (aufgerufener Host oder Projekt-Haupthost)
rotate	positive Werte drehen das erzeugte Bild im Uhrzeigersinn, negative Werte entgegen (in Grad, z.B. 90)die Größe des erzeugten Bildes wird neu berechnet, um den rotierten Barcode unterzubringen (Hintergrund ggf. transparent)

Es ist generell empfehlenswert einen minimalen Kontrast-Rand (z.B. in weiß) zu setzen, damit Barcodeleser den Code einfacher identifizieren können.

Es kann weitere Einschränkungen, je nach offizieller Spezifikation des jeweiligen Barcode-Types, geben, die hier nicht extra aufgeführt sind.Die Ausgabegröße des Barcode-Bilds musst nicht exakt der angegebenen `width` / `height` entsprechen (liegt aber zumindest nicht darüber). Falls eine pixelgenaue Ausgabe benötigt wird, sollte ein Container um das Bild gepackt werden.

Typ-spezifische Informationen

Die gezeigten Beispiele müssen nicht unbedingt den Anforderungen des jeweiligen Standards entsprechen! Es können also auch potentiell invalide Barcodes entstehen. Es ist die Spezifikation des jeweiligen Types zu Rate zu ziehen!

1-Dimensionale Codes

Bei allen 1-dimensionalen Codes kann der parameter margin verwendet werden. Dieser legt die Größe des Randes links und rechts fest (0 für keinen Rand, Standard ist 10).

Typ	Ausgabe	spezielle Parameter	Einschränkungen
<bx:barcode.codabar>	"12345"		beginnt und endet mit einem Guard-Zeichen aus: ABCDODER beginnt und endet mit einem Guard-Zeichen aus: TN*Efalls keine Guards gesetzt sind, wird automatisch A genommenenthält nur Zeichen aus: 0123456789-$:/.+
<bx:barcode.code_39>	"BATIX"		maximal 80 Zeichen aus: 0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ-. *$/+%
<bx:barcode.code_93>	"BATIX"		maximal 80 Zeichen aus:0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ-. $/+%abcd*
<bx:barcode.code_128>	"BATIX"		maximal 80 Zeichen
<bx:barcode.itf> (Interleaved Two of Five)	"123456"		weniger als 80 Ziffern, gerade Anzahlam besten 6, 10, 12, 14, 16, 24, oder 44 Ziffern
<bx:barcode.ean_8>	"12345678"		genau 8 Ziffern
<bx:barcode.ean_13>	"1234567891118"		genau 13 ZiffernPrüfziffer muss stimmen
<bx:barcode.upc_a>	"12345678910"		genau 11 Ziffern (ohne Prüfziffer, wird automatisch berechnet)ODER genau 12 Ziffern (mit Prüfziffer)
<bx:barcode.upc_e>	"12345678"		genau 8 Ziffern

2-Dimensionale Codes

Typ	Ausgabe	spezielle Parameter	Einschränkungen
<bx:barcode.qr>	"http://batix.de"	ecl margin charset	Achtung: Die Länge des verschlüsselten Strings kann die Ausgabe beeinflussen
<bx:barcode.datamatrix>	"http:/batix.de" (rechts mit shape=square)  "Lorem ipsum dolor sit amet" (rechts mit shape=rectangle)	shapenone (Standard, es wird automatisch je nach Inhalt das passende Shape gewählt)square (Quadrat erzwingen)rectangle (Rechteck erzwingen)
<bx:barcode.aztec>	"http://batix.de"	ecl layers charset
<bx:barcode.pdf_417>	"BATIX"	margin ecl charset compact compaction dimensions

Fehlerabfrage

<bx:if><bx:barcode.ean_8>1234</bx:barcode.ean_8><bx:if.else>Es konnte leider kein Barcode erzeugt werden!</bx:if.else></bx:if>

Da bx:barcode im Fehlerfall nichts ausgibt, kann ein alternativer Text mittels bx:if ausgegeben werden.

Beispiele

Beispiel Titel

<bx:barcode.qr>Hallo</bx:barcode.qr>
 
<bx:barcode.datamatrix shape="rectangle">Hallo</bx:barcode.datamatrix>