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

PublicadoHerramientaEditor de viewBox SVG

Contenido
  1. El problema: por qué la imagen no cambia aunque aumentes el tamaño
  2. La causa: width y height son valores distintos de viewBox
  3. Cómo comprobarlo: averiguarlo solo mirando el código
  4. Puntos donde suele haber bloqueos
  5. En resumen
  6. Preguntas frecuentes

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.

  1. Abre el código SVG y busca la etiqueta <svg ...>.
  2. 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ñadiendo viewBox="0 0 ancho alto".
  3. 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.
  4. 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.

Editor de viewBox SVG

Gratis · sin registro · todo se procesa en el navegador (nada se envía al servidor)

Puntos donde suele haber bloqueos

SíntomaCausa
Al aumentar el tamaño la imagen no crece y solo se ve una parteNo existe el atributo viewBox
Aparece un margen no deseado alrededor de la imagenLa proporción del viewBox y la de width y height son distintas, así que se coloca reducida
Se ve una parte de la imagen recortadaEl 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ñaEl 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.

Editor de viewBox SVG

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

Artículos relacionados

  1. Marca de agua en la esquina: desaparece con un solo recorteUna marca de agua solo en una esquina se elimina recortando esa zona. Por qué el texto repetido en diagonal no se puede quitar con un recorte.
  2. Fondo borroso en tarjetas e Instagram: cómo ajustarloPor qué el fondo de las tarjetas y posts de Instagram va desenfocado y cómo ajustar la intensidad del blur para que el texto se lea bien.
  3. Por qué no puedes copiar el texto de una foto y cómo comprobarloExplicamos por qué las letras de una foto o captura no se pueden seleccionar, cómo funciona el OCR y qué factores cambian la precisión del reconocimiento.
  4. Quitar el fondo de imágenes con IA: PNG transparente en segundosCómo funcionan la segmentación de imágenes y el alpha matting, y cómo quitar el fondo de una foto para guardarla como PNG transparente sin Photoshop.
  5. Por qué la foto se quema al subir brillo y contrasteEl clipping: por qué las luces se queman y las sombras se empastan al subir brillo o contraste, cómo verlo en el histograma y hasta dónde subir.
  6. Capturas de código borrosas: por qué pasa y cómo evitarloPor qué las capturas de código se ven borrosas en el blog o en redes y cómo revisar los píxeles reales del archivo para generar imágenes nítidas.

Herramientas relacionadas