Coordenadas internas e área de exibição
O atributo viewBox define uma região retangular de coordenadas internas que o navegador ajusta à área de exibição de um SVG. Os dois primeiros números indicam as coordenadas mínimas horizontal e vertical. A largura e a altura da região vêm em seguida, em unidades do desenho.
Essa região permite manter as coordenadas do desenho mesmo quando o SVG ocupa outro tamanho na página. O navegador calcula uma transformação entre as coordenadas internas e o espaço disponível. A forma desse ajuste também depende do atributo preserveAspectRatio.
Um desenho de 100 por 50 unidades
O SVG deste exemplo usa uma região interna de 100 por 50 unidades e uma área de exibição de 200 por 100 pixels:
<svg xmlns="http://www.w3.org/2000/svg" width="200" height="100" viewBox="0 0 100 50"> <rect x="0" y="0" width="100" height="50" fill="blue" /></svg>O retângulo começa na origem e ocupa toda a região do viewBox. Como as proporções interna e externa são iguais, o navegador duplica as medidas para exibir um retângulo azul de 200 por 100 pixels. Esse resultado pressupõe que o CSS da página não sobrescreva as dimensões do elemento.
Ajustar a proporção sem deformar o desenho
Com o valor padrão xMidYMid meet de preserveAspectRatio, o navegador mantém a proporção e centraliza a região interna para que ela caiba inteira na área disponível. Uma área quadrada para o mesmo exemplo terá espaço livre acima e abaixo do desenho.
O valor none permite ajustar os eixos de forma independente e pode deformar o conteúdo. Ao revisar um ícone, confira tanto o viewBox quanto as dimensões externas: aumentar a largura na página não altera as coordenadas gravadas no desenho.
Dúvidas frequentes
Perguntas frequentes sobre viewBox
- Quais são os quatro valores do viewBox?
- Os dois primeiros definem a coordenada horizontal mínima e a vertical mínima. Os dois últimos definem a largura e a altura da região. Em viewBox="0 0 100 50", a origem é zero nos dois eixos e a região mede 100 por 50 unidades internas.
- O viewBox define o tamanho do SVG em pixels?
- O atributo define coordenadas internas. A largura e a altura de exibição podem ser definidas no elemento ou pelo CSS. O navegador calcula como ajustar a região interna a essa área.
- O que acontece com uma largura ou altura igual a zero?
- Uma largura ou altura igual a zero no viewBox desativa a renderização do elemento. Valores negativos para essas dimensões são inválidos. As coordenadas mínimas, por sua vez, podem ser negativas.
Para continuar
Recursos relacionados
Documentação
MDN: região de coordenadas do viewBox
Referência da MDN sobre a sintaxe dos quatro valores e os elementos SVG que aceitam viewBox.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para revisar as dimensões e o ajuste de ícones SVG na interface da sua aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao ajustar ícones SVG na interface, você precisa conferir como as coordenadas internas se relacionam com o tamanho exibido na página.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.