¿Qué es viewBox en SVG? Por qué tu icono no cambia de tamaño

Contenido
Habrás visto alguna vez un SVG descargado de una librería de iconos que, al meterlo en un botón y aumentar su tamaño, se queda igual o solo se amplía una esquina y aparece recortado. Esto no ocurre por escribir mal el CSS, sino porque el valor de viewBox y los atributos width y height dentro del código SVG cumplen funciones distintas. Si sabes leer los cuatro números de viewBox, puedes encontrar la causa con solo mirar el código.
Resumen ① El tamaño de un SVG se decide por separado con dos cosas: el width y el height que se ven en pantalla, y el viewBox que contiene las coordenadas de las figuras. ② Si no hay viewBox, el navegador usa los valores de width y height como unidades de coordenadas, así que al aumentar el tamaño la imagen no crece y parece recortada. ③ Si revisas los cuatro números del viewBox (minX minY width height), puedes distinguir si la causa es un recorte, un margen o un desplazamiento.
El problema: por qué la imagen no cambia aunque aumentes el tamaño
Supón que descargas un archivo SVG de 24×24 de un set de iconos y lo colocas dentro de un botón. Lo agrandas con style="width:64px;height:64px", pero el icono no crece: parece que solo se amplió la esquina superior izquierda, o que el lado derecho y el inferior se recortaron por completo.
También puede ocurrir lo contrario: que aparezca un margen sin motivo alrededor de la imagen. Ninguno de los dos síntomas se soluciona tocando el CSS otra vez, porque la causa no está en el CSS sino dentro del código SVG.
La causa: width y height son valores distintos de viewBox
En la etiqueta SVG hay valores relacionados con el tamaño repartidos en dos lugares. Uno son los atributos width y height (o el CSS), que determinan el tamaño físico que el SVG ocupa en pantalla. El otro es el atributo viewBox, que determina sobre qué sistema de coordenadas se dibujan las figuras como circle, rect o path.
Cuando existe un viewBox, el navegador amplía o reduce ese sistema de coordenadas automáticamente para ajustarlo al tamaño físico. Es parecido a redimensionar una foto de forma automática para que encaje en el marco. Por eso, si cambias los valores de width y height, la imagen completa crece o se reduce manteniendo la proporción.
El problema es cuando no hay viewBox en absoluto. En ese caso el navegador no tiene una referencia para redimensionar las coordenadas de las figuras y usa los valores de los atributos width y height como si fueran unidades de coordenadas. Si en esa situación solo aumentas el tamaño físico con CSS, únicamente se ensancha el lienzo (la ventana visible), mientras las figuras de dentro se quedan en sus coordenadas originales, apiñadas en un lado o con aspecto de estar recortadas.
Cómo comprobarlo: averiguarlo solo mirando el código
No necesitas ninguna herramienta aparte: la causa se distingue con solo mirar el código.
- Abre el código SVG y busca la etiqueta
<svg ...>. - Si no existe ningún atributo
viewBox="...", esa es la causa. Se soluciona tomando tal cual los valores actuales de width y height y añadiendoviewBox="0 0 ancho alto". - Si hay viewBox pero el tercer número (ancho) o el cuarto (alto) es menor que el tamaño real de la figura, una parte de la imagen se recorta.
- Si los dos primeros números del viewBox (minX, minY) no son 0, la figura parece desplazada en esa medida. No se ha movido la figura, sino la zona visible (la ventana).
Compruébalo con nuestra herramienta. Para ver esta relación con tus propios ojos, pega el código SVG y cambia uno a uno los cuatro números del viewBox. El resultado se refleja al instante en la vista previa en vivo, así que puedes comparar directamente qué número provoca el recorte y cuál provoca el desplazamiento.
Gratis · sin registro · todo se procesa en el navegador (nada se envía al servidor)

Puntos donde suele haber bloqueos
| Síntoma | Causa |
|---|---|
| Al aumentar el tamaño la imagen no crece y solo se ve una parte | No existe el atributo viewBox |
| Aparece un margen no deseado alrededor de la imagen | La proporción del viewBox y la de width y height son distintas, así que se coloca reducida |
| Se ve una parte de la imagen recortada | El tercer y cuarto número del viewBox (ancho y alto) son menores que la figura real |
| La posición de la imagen parece desplazada de forma extraña | El primer y segundo número del viewBox (minX, minY) no son 0 |
En resumen
Los problemas de tamaño en SVG se explican casi siempre por uno de los cuatro números del viewBox. width y height solo determinan el tamaño físico que se ve en pantalla, y es el viewBox el que decide cómo se colocan las figuras dentro.
Si confundes ambos valores, perderás tiempo buscando la causa únicamente en el CSS. Si adquieres la costumbre de comprobar primero en el código si existe viewBox y cuáles son sus cuatro números, podrás acotar rápidamente la mayoría de los problemas de iconos recortados o desplazados.
Gratis · sin registro · todo se procesa en el navegador (nada se envía al servidor)
Preguntas frecuentes
¿Qué significa cada uno de los cuatro números del viewBox?
En orden: minX, minY, width y height. Los dos primeros números son el punto donde empieza la zona visible dentro del sistema de coordenadas (el punto de referencia superior izquierdo), y los dos últimos determinan qué extensión de área se muestra a partir de ese punto. Las coordenadas de la figura en sí (como cx y cy de un circle) quedan fijas al margen de estos valores, y el viewBox solo decide qué parte de ellas se recorta y con qué escala se muestra.
¿Puedo borrar los atributos width y height y dejar solo el viewBox?
Sí; de hecho, muchas librerías de iconos usan este método. Si no hay atributos width y height, el SVG ocupa el tamaño que indique el elemento padre o el CSS, y el viewBox mantiene la proporción entre las figuras. Es una estructura que se usa a menudo cuando quieres cambiar el tamaño de los iconos libremente y de forma responsive.
¿Cómo se corrige un SVG que no tiene viewBox?
La forma más sencilla es tomar tal cual los valores actuales de width y height y añadir viewBox="0 0 valor-de-width valor-de-height". Por ejemplo, si tenía width="24" height="24", añade viewBox="0 0 24 24". Después, aunque cambies width y height con CSS, el tamaño se ajustará manteniendo la proporción de las figuras.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano