Gerador de código QR

Um QR code é um código de barras bidimensional que armazena texto diretamente no seu padrão de módulos pretos e brancos. A câmera de um celular faz a leitura, decodifica o texto e, se esse texto for uma URL, abre o endereço. Como os dados ficam na própria imagem, um código gerado aqui funciona para sempre, sem um serviço de redirecionamento que possa expirar ou rastrear as leituras.

Como funciona

Digite qualquer texto ou URL. A ferramenta monta o símbolo no seu navegador com a biblioteca qrcode-generator, deixando que ela escolha o menor dos 40 tamanhos padrão (versões) em que seus dados cabem, e o renderiza como SVG. Dois controles definem o resultado:

• Tamanho define a largura em pixels de um módulo, de 3 a 12. Ele afeta o download em PNG e a pré-visualização; já o SVG escala para qualquer tamanho.
• Correção de erros escolhe quanta redundância é codificada. O nível L se recupera de cerca de 7% de danos, o M de cerca de 15%, o Q de cerca de 25% e o H de cerca de 30%. Níveis mais altos geram um código mais denso para o mesmo texto.

A entrada é limitada a 2.000 caracteres. O texto é codificado no modo byte como UTF-8, então alfabetos não latinos e emojis funcionam, mas cada um desses caracteres ocupa vários bytes; um texto longo fora do ASCII no nível H pode ultrapassar a capacidade da versão 40, e nesse caso a ferramenta pede um texto mais curto em vez de gerar um código ilegível.

Baixar SVG salva o arquivo vetorial, a escolha certa para impressão, sinalização e qualquer coisa que vá ser redimensionada. Baixar PNG desenha os mesmos módulos em um canvas com fundo branco e salva uma imagem rasterizada cujo tamanho é (módulos + 8) × pixels por módulo; o 8 corresponde à zona de silêncio obrigatória de quatro módulos em cada lado.

Como gerar um código que funcione na leitura

Mantenha o conteúdo curto. Uma URL de 40 caracteres gera um código pequeno e tolerante; um vCard de 500 caracteres gera um código denso, que exige uma boa câmera e mão firme. Se você controla o destino, aponte o código para um caminho curto e faça o redirecionamento no seu próprio servidor.

Inclua o esquema. https://example.com é reconhecido como link por qualquer leitor; example.com sozinho pode ser tratado como texto simples.

Ajuste a correção de erros ao ambiente. O M é suficiente para telas e papel limpo. Use Q ou H quando o código for impresso em tamanho pequeno, colocado ao ar livre ou quando você pretender sobrepor um logotipo no centro, o que destrói de propósito parte dos módulos e depende da redundância para compensar.

Preserve a zona de silêncio e o contraste. Os leitores esperam módulos escuros sobre fundo claro; esquemas de cores invertidos ou de baixo contraste e margens cortadas são os motivos mais comuns para um código falhar no mundo real. Sempre teste o material impresso final com mais de um celular.

O que a ferramenta não faz

Ela não encurta links, não conta leituras e não permite trocar o destino depois da impressão. Esses recursos exigem um serviço de redirecionamento entre o leitor e a sua página, o que tem um preço: praticidade e métricas em troca de uma dependência e de um custo de privacidade para quem faz a leitura. Se você precisa de códigos dinâmicos, codifique uma URL sua e gerencie o redirecionamento por conta própria.

Ela também não gera códigos de Wi-Fi, agenda ou pagamento a partir de um formulário, embora você possa digitar esses formatos à mão; um código de Wi-Fi é, por exemplo, a string WIFI:T:WPA;S:NetworkName;P:password;;.

Equivalente na linha de comando

O qrencode gera os mesmos símbolos a partir de um shell:

qrencode -l M -s 6 -o qr.png 'https://example.com'
qrencode -l H -t SVG -o qr.svg 'https://example.com'

Saiba mais

Como incorporar a saída SVG diretamente em uma página, dimensioná-la de forma responsiva e dar a ela um texto alternativo é assunto de Fundamentos de HTML5. Se o código carregar uma URL com parâmetros, passe antes os valores pelo codificador de URL e, se precisar reduzir um PNG para a web, o compressor de imagens vai convertê-lo para WebP.