QR code e código de barras em PDF gerado a partir de HTML
Publicado em 2 min de leitura
Um ingresso precisa de um código que um leitor consiga ler. Uma etiqueta de envio precisa de um código de barras. Uma fatura fica mais fácil de pagar com um QR code que abre o link de pagamento. Dá para desenhar os três com a linguagem de template do rustedf.cloud, sem gerar uma imagem antes.
Dois filtros
{{ pay_url | qr(size=30) | safe }}{{ number | barcode(width=60, height=15) | safe }}qr desenha um QR code e barcode desenha um código de barras Code 128, ambos a partir de
qualquer texto ou número dos seus dados. O filtro safe está ali porque o código é um markup
que o próprio serviço desenha. Os seus dados continuam escapados.
Um ingresso, do começo ao fim
<style> @page { size: A4; margin: 20mm; } body { font-family: sans-serif; } .ingresso { width: 120mm; border: 2px solid #111; padding: 8mm; } h1 { margin: 0 0 4mm; }</style>
<div class="ingresso"> <h1>{{ event.name }}</h1> <p>{{ event.date | date(style="long") }}<br>{{ holder }}</p> {{ ticket_url | qr(size=40) | safe }} <p>{{ code }}</p> {{ code | barcode(width=70, height=18) | safe }}</div>{ "event": { "name": "Noite de Estúdio Aberto", "date": "2026-12-05" }, "holder": "Marina Costa", "ticket_url": "https://example.com/t/8f3a-91c2", "code": "TKT-0042-8F3A"}Cada ingresso é uma geração com os seus próprios dados. Para fazer um lote, chame o endpoint uma vez por ingresso.
Tamanhos e limites
| Filtro | Argumentos | Aceita |
|---|---|---|
qr |
size em milímetros (5 a 200, 30 por padrão), level de correção de erros L, M, Q ou H (M), margin da zona de silêncio em quadrados (0 a 10, 4) |
Até 1000 bytes de texto. |
barcode |
width e height em milímetros (20 a 200 e 5 a 100; 60 e 15), margin da zona de silêncio em módulos (0 a 20, 10) |
Até 80 letras, dígitos e pontuação, sem acentos. |
Algumas coisas decorrem disso:
- Um código é um conjunto de retângulos vetoriais, então fica nítido em qualquer tamanho, na tela ou impresso.
- Um
levelde correção mais alto deixa um QR code sobreviver a mais danos, ao custo de um padrão mais denso. Mantenha o padrão, a menos que saiba que um código impresso vai se desgastar. - Um código de barras não aceita acentos. Se um valor pode tê-los, use um código simples (um número de pedido, um código de rastreio) em vez de um nome.
- Não mexa na zona de silêncio. Os leitores precisam de espaço vazio em volta de um código para encontrá-lo.
Entrada inválida
Um valor ausente ou vazio não desenha nada, então um documento sem link simplesmente não tem código. Um valor que não cabe, como um texto acima do limite ou acentos em um código de barras, é um erro, e não um código que falha em silêncio na leitura. Todos os códigos de um documento, juntos, são limitados a 4 MiB de markup, muito mais do que uma página precisa.
Confira antes de imprimir
Leia um teste impresso, não só a tela. E rode POST /v1/validate no seu template: ele reporta
o que o gerador não conseguiu desenhar, sem devolver o PDF nem usar crédito.
Veja Templates para a lista completa de filtros e Validar um documento.
Continue lendo
Layout do PDF
Quebra de página em PDF com CSS: blocos e tabelas sem cortes
Controle onde uma página do PDF termina: force uma página nova, mantenha uma assinatura ou um total inteiro e deixe tabelas longas seguirem com o cabeçalho.
2 min de leitura
Layout do PDF
Número de página, cabeçalho e rodapé em PDF com HTML e CSS
Coloque "Página 2 de 5", um título corrente e um aviso de confidencial em todas as páginas de um PDF com a regra @page do CSS. Exemplos e o que conferir.
2 min de leitura
Código e integrações
Gerar PDF no ASP.NET Core: MVC, Razor Pages e minimal APIs
Transforme uma view Razor em PDF no ASP.NET Core com uma chamada de API: renderizador de views, view pronta para impressão, action MVC e handler do Razor Pages.
3 min de leitura
Código e integrações
Converter página web em PDF em C# sem navegador headless
Busque uma página com HttpClient e transforme o HTML em PDF com uma chamada de API em C#. Quais páginas isso atende, quais não e como conferir antes de depender.
3 min de leitura