Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é viewBox?

    O atributo viewBox define a região de coordenadas que o SVG ajusta à sua área de exibição. Seus valores controlam a origem e as dimensões internas do desenho.

    Também chamado de: SVG viewBox

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano