Nexus – Elemento: QR / Barcode
¿Qué es?
QR / Barcode es un componente de tipo Display. Genera códigos QR o códigos de barras a partir de un valor de texto, con distintos formatos de codificación. Al arrastrarlo al lienzo viene con un QR de ejemplo precargado, apuntando a una URL.
Propiedades
Al seleccionar el componente en el lienzo, el panel derecho muestra “Properties of CodeGenerator” con las siguientes opciones:
- Component ID: identificador único del componente, autogenerado (ej.
cdg_cfef03b2). - Visibility → Hidden on load: casilla para que el componente esté oculto al cargar la pantalla. Puede mostrarse luego mediante una acción de tipo Show (ver Events & Actions).
- Value: el texto o dato que se va a codificar (ej. una URL, un número, un código).
- Mode: menú desplegable que define si el componente genera un QR o un Barcode (código de barras lineal).
- Behavior → Barcode Format (solo visible en modo Barcode): define el estándar de codificación del código de barras. Opciones: CODE128, CODE39, EAN13, EAN8, UPC, ITF14, MSI, Pharmacode.
- Show Barcode Value: casilla que muestra el valor en texto debajo del código de barras.
- Style → Width (px) / Height (px): dimensiones del código generado (valor por defecto: 180×180).
- Style → Margin: margen alrededor del código.
- Style → Barcode Line Color: color de las líneas/módulos del código.
- Style → Barcode Background: color de fondo del código.
- Style → Alignment: alineación del componente. Opciones: Left, Center, Right.
- Style → Custom Class: clase CSS personalizada.
- Style → Custom Style: CSS personalizado aplicado directamente a este componente.
- Delete Component: elimina el componente del lienzo.
- Events & Actions: sistema para definir comportamientos interactivos. Ver documentación aparte: Nexus – Events & Actions .
Ejemplo de uso — formatos de Barcode
Cada formato de código de barras tiene reglas propias sobre qué valores acepta (algunos piden solo números, otros una cantidad exacta de dígitos). Se probó cada formato con un valor de ejemplo y funcionaron correctamente:
| Formato | Uso típico | Valor de prueba usado |
|---|---|---|
| CODE128 | Genérico, acepta letras, números y símbolos. Muy usado en logística. | Nexus-2026 |
| CODE39 | Alfanumérico (mayúsculas, números y algunos símbolos). Usado en industria/gobierno. | NEXUS123 |
| EAN13 | Código de producto de retail (13 dígitos numéricos exactos). | 4006381333931 |
| EAN8 | Versión corta de EAN, para productos pequeños (8 dígitos numéricos). | 96385074 |
| UPC | Estándar de retail en EE.UU./Canadá (12 dígitos numéricos). | 036000291452 |
| ITF14 | Usado en cajas/embalajes de logística (14 dígitos numéricos). | 10012345678902 |
| MSI | Usado en inventario y estanterías (solo números). | 1234567 |
| Pharmacode | Usado en packaging farmacéutico (número simple, sin chequeo). | 1234 |
Para probar cualquier formato: cambiar Mode a
Barcode, elegir el formato deseado en Barcode Format, y pegar en Value un dato acorde a ese estándar (por ejemplo, para EAN13 debe ser un número de 13 dígitos, para UPC de 12 dígitos, y para Pharmacode simplemente un número simple sin formato especial).