Quando imagens em Base64 são úteis
Normalmente, uma página da web aponta para um arquivo de imagem separado. Uma data URI em Base64 coloca a imagem dentro do próprio texto, o que é prático em alguns casos específicos:
- Ícones e logos pequenos em HTML ou CSS. Uma setinha, um ícone de carregamento ou um logo de 2 KB evita que o navegador faça uma requisição a mais.
- Documentos de arquivo único. Um relatório em HTML, uma página offline ou um modelo de e-mail que precisa funcionar como um só arquivo, sem pasta de imagens.
- APIs e JSON. Muitos serviços pedem a imagem em um campo Base64 — por exemplo, para enviar uma foto de perfil, mandar um documento digitalizado ou chamar uma API de reconhecimento de imagem.
- Assinaturas de e-mail e newsletters. Alguns editores só aceitam imagem como data URI. Atenção: vários programas de e-mail (entre eles o Outlook e o Gmail) bloqueiam ou removem data URIs incorporadas, então teste antes de enviar para todo mundo.
- Favicons e SVG no CSS. Um ICO ou SVG pequeno pode ser escrito direto na folha de estilos.
Qual formato escolher?
| Formato | Aparência | Use para |
|---|---|---|
| Data URI | data:image/png;base64,iVBOR… | src de img, url() do CSS, Markdown, a maioria dos campos JSON |
| Só o código Base64 | iVBORw0KGgo… | Campos de API que pedem só o código e enviam o tipo separadamente |
| Tag img do HTML | um elemento img com a data URI no src | Colar direto em uma página HTML ou em um modelo de e-mail |
| Regra CSS | background-image com url("data:…") | Folhas de estilos, atributos style inline |
Se estiver em dúvida, escolha Data URI — é a que funciona na maioria dos lugares. Para exemplos prontos para copiar e dicas de tamanho, veja Como incorporar uma imagem em HTML ou CSS com Base64. Tem um código Base64 e precisa da imagem de volta? Use Base64 para imagem.
Mantenha a imagem pequena
O Base64 funciona melhor com imagens pequenas. Uma regra prática:
- Abaixo de 10 KB (ícones, logos simples): vale a pena incorporar.
- De 10 a 100 KB: tudo bem para documentos de arquivo único e e-mails, nem tanto para uma página da web acessada com frequência.
- Acima de 100 KB: geralmente é melhor como arquivo de imagem normal. O texto fica um terço maior que a imagem, não pode ir para o cache separadamente e atrasa o resto da página.
Para diminuir uma imagem antes de converter, use Comprimir PNG ou Comprimir JPG, ou reduza o tamanho em pixels com Redimensionar imagem. Para ícones e logos, um SVG costuma ser a opção mais leve de todas.
Se algo der errado
"Não foi possível abrir esta imagem." O arquivo não é de um dos tipos de imagem aceitos ou está corrompido. Fotos HEIC do iPhone não aparecem como data URI na maioria dos navegadores — converta-as antes para JPG.
"Esta imagem tem mais de 10 MB." Um texto desse tamanho não é prático de colar em nenhum editor ou formulário. Comprima ou redimensione a imagem antes.
A imagem não aparece onde eu colei. Confira se você copiou o texto inteiro (é fácil cortar um resultado longo sem querer — baixar o arquivo .txt evita isso) e se o lugar onde você colou aceita data URIs; alguns programas de e-mail e filtros de conteúdo as removem de propósito.