SVG (1)

En esta lección se trata la etiqueta principal de SVG, la etiqueta <svg>. Las formas básicas SVG (líneas, rectángulos, círculos, curvas, etc.) se comentan en la lección Formas básicas SVG. Algunas formas más avanzadas se comentan en la lección Formas avanzadas SVG. En la lección SVG (2) se tratan otros aspectos relacionados con las imágenes SVG.

Qué es SVG

SVG (Scalable Vector Graphics = Gráficos Vectoriales Escalables) es un lenguaje de marcas creado por el W3C y dirigido a la representación de gráficos vectoriales (dibujos y texto).

En la lección sobre Historia de la Web) se comentan las recomendaciones de SVG publicadas o en preparación por el W3C.

En un gráfico vectorial, los elementos de la imagen están definidos como formas elementales (líneas, rectángulos, círculos, curvas, polígonos, etc.), definidas mediante etiquetas similares a las del HTML. Por ello SVG no es un formato adecuada para fotografías, pero es idóneo para cualquier tipo de dibujo, técnico o artístico.

Las ventajas de SVG son muchas:

Un gráfico SVG puede incluirse en una página web de dos maneras, como objeto interno o como objeto externo.

Desgraciadamente, el uso de SVG se vio frenado porque Internet Explorer no fue capaz de mostrar gráficos SVG hasta IE 9 y de forma deficiente. Actualmente (octubre de 2019), los principales obstáculos al uso generalizado de SVG siguen siendo que las implementaciones en los navegadores todavía son incompletas y los potenciales riesgos de seguridad (debido a que las imágenes SVG pueden contener código Javascript, se recomienda no incorporar imágenes SVG sin haber comprobado antes su contenido).

De todas formas, SVG se ha ido imponiendo poco a poco como formato estándar de gráficos vectoriales frente a otros formatos propietarios y numerosos programas de edición de gráficos son capaces de importar y exportar en formato SVG.

Para saber más

Sintaxis de SVG

SVG es un lenguaje XML, por lo que su sintaxis sigue las reglas del XML. SVG 2.0 (actualmente, octubre de 2019, en elaboración) permitirá que el SVG incluido en un documento HTML5 siga la sintaxis HTML, pero por el momento las etiquetas SVG incluidas en páginas web deben seguir la sintaxis XML.

En la lección Diferencias entre HTML y XHTML se comentan las diferencias de sintaxis entre HTML y XHTML (que son las mismas que entre HTML y SVG, ya que tanto XHTML como SVG son lenguajes basados en XML). Las más llamativas son las siguientes:

Imágenes SVG

Una imagen SVG puede incluirse en una página web directamente o puede enlazarse mediante la etiqueta <img>, como se comenta en la lección Imágenes.

El ejemplo siguiente muestra una imagen SVG incluida en una página web (concretamente, en un párrafo <p>):

ERROR (no puede mostrarse el objeto)
<p>
  <svg version="1.1" xmlns="http://www.w3.org/2000/svg"
    width="170" height="165" viewBox="0 0 170 165">
    <polygon fill="yellow" stroke="red" stroke-width="7"
      points="129,150 85,119 41,150 57,104 15,66
        68,66 85,15 102,65 156,66 113,98" />
  </svg>
</p>
Enlace externo

El ejemplo siguiente muestra una imagen SVG enlazada desde una página web (mediante la etiqueta <img> y el contenido del fichero enlazado (estrella.svg):

ERROR (no puede mostrarse el objeto)
<p><img src="estrella.svg" alt="Estrella SVG"></p>
<?xml version="1.0" encoding="UTF-8" ?>
<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
  width="170" height="165" viewBox="0 0 170 165">
  <polygon fill="yellow" stroke="red" stroke-width="7"
    points="129,150 85,119 41,150 57,104 15,66
      68,66 85,15 102,65 156,66 113,98" />
</svg>
  
Enlace externo

La declaración xml (la primera línea del fichero estrella.svg del ejemplo anterior) es optativa si la versión de XML es 1.0 y obligatoria si la versión de XML es 1.1. En cualquier caso, se aconseja incluirla y aprovecharla para declarar el juego de caracteres del documento (como en el ejemplo, UTF-8).

El plano SVG

Los dibujos SVG se definen en un plano infinito en el que el eje Y está orientado hacia abajo, como muestra el dibujo siguiente en el que se muestran los ejes de coordenadas, cuatro puntos en rojo y sus coordenadas.

Y X (100, 100) (100, -100) (-100, -100) (-100, 100)

La etiqueta <svg>

La etiqueta <svg> engloba toda la imagen SVG e incluye las formas que forman la imagen.

Los atributos version y xmlns

El atributo version de la etiqueta <svg> indica la versión de SVG empleada en el dibujo. En estos apuntes se utiliza la versión 1.1. Este atributo no es obligatorio, pero está recomendado para ayudar a los navegadores (aunque en la práctica parece ser que los navegadores no tienen en cuenta este atributo).

El atributo xmlns de la etiqueta <svg> indica el espacio de nombres empleado en el dibujo, es siempre https://www.w3.org/2000/svg. Este atributo es obligatorio cuando la imagen SVG se encuentra en un fichero aparte (con la extensión .svg), pero este atributo es optativo cuando la imagen SVG está incluida en una página web.

Aunque no sea necesario, en estos apuntes se aconseja incluir siempre los atributos version y xmlns como en el ejemplo siguiente:

<svg version="1.1" xmlns="http://www.w3.org/2000/svg" ...

Referencias: Pregunta en stackoverflow sobre la obligatoriedad de los atributos version y xmlns

El atributo viewBox

El atributo viewBox establece la porción del plano SVG que muestra la imagen. Este atributo se establece con cuatro valores:

El ejemplo siguiente muestra con una línea roja a trazos la porción del plano SVG que se mostraría con unos valores determinados en el atributo viewbox.

Y X viewBox="-100 -50 200 150" (-100, -50) (100, 100)

La zona visible es independiente de los elementos dibujados, es decir, sólo se mostrarán los elementos (o la parte de los elementos) que se encuentren en la zona visible definida por el atributo viewbox.

Los ejemplos siguientes muestran tres dibujos con los mismos elementos SVG: los ejes de coordenadas y un círculo de radio 100 centrado en el origen, pero con diferentes atributos viewbox

Los atributos width y height de <svg>

El atributo viewBox establece la porción del plano SVG que se muestra en la imagen, mientras que los atributos width y height establecen el ancho y el alto de la imagen en la página web. Si no se indican unidades, los valores se interpretan en px.

Así, una misma imagen en el plano SVG se puede ver en la página web más o menos grande, como muestran los ejemplos siguientes:


Si no hay atributo viewBox, la zona visible empieza en el origen (0, 0) y el tamaño definido por width y height es el tamaño de la zona visible.

<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
     width="100" height="100"
     style="background-color: lightgray">
  <circle cx="0" cy="0" r="50" fill="none" stroke="red" stroke-width="1" />
</svg>

Elementos superpuestos

Los elementos de un dibujo SVG se van dibujando en el mismo orden en que se encuentran en el código fuente. Si dos elementos se superponen, uno se dibujará sobre el otro, como muestran los ejemplos siguientes.

<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
     width="220" height="170"   viewBox="-10 -10 220 170">
  <circle cx="75" cy="75" r="75" fill="red" />
  <circle cx="125" cy="75" r="75" fill="mediumseagreen" />
</svg>
<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
     width="220" height="170"   viewBox="-10 -10 220 170">
  <circle cx="125" cy="75" r="75" fill="mediumseagreen" />
  <circle cx="75" cy="75" r="75" fill="red" />
</svg>
  

Un elemento puede así ocultar completamente a otro, como muestran los ejemplos siguientes.

<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
     width="220" height="170"   viewBox="-10 -10 220 170">
  <circle cx="100" cy="75" r="75" fill="red" />
  <circle cx="100" cy="75" r="50" fill="mediumseagreen" />
</svg>
<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
     width="220" height="170"   viewBox="-10 -10 220 170">
  <circle cx="100" cy="75" r="50" fill="mediumseagreen" />
  <circle cx="100" cy="75" r="75" fill="red" />
</svg>
  

Una manera de no ocultar los objetos superpuestos es utilizar el relleno transparente (fill="none"), como muestran los ejemplos siguientes. El elemento con relleno transparente deberá tener color de trazo (stroke="color") para que sea visible.

<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
     width="220" height="170"   viewBox="-10 -10 220 170">
  <circle cx="100" cy="75" r="75" fill="white" stroke="red" />
  <circle cx="100" cy="75" r="50" fill="mediumseagreen" />
</svg>
<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
     width="220" height="170"   viewBox="-10 -10 220 170">
  <circle cx="100" cy="75" r="50" fill="mediumseagreen" />
  <circle cx="100" cy="75" r="75" fill="white" stroke="red" />
</svg>
<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
     width="220" height="170"   viewBox="-10 -10 220 170">
     <circle cx="100" cy="75" r="50" fill="mediumseagreen" />
     <circle cx="100" cy="75" r="75" fill="none" stroke="red" />
</svg>
  

Márgenes en viewBox

Para asegurarse de que todo el dibujo sea visible, es conveniente elegir un viewbox un poco más grande que la zona ocupada por los elementos del dibujo.

En el ejemplo siguiente los centros de los círculos está situado en la esquina superior izquierda y en la esquina inferior derecha de la zona visible y por eso sólo puede verse la cuarta parte de ambos círculos.

<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
   width="100" height="100"   viewBox="0 0 100 100">
   <circle cx="0" cy="0" r="10" fill="red" />
   <circle cx="100" cy="100" r="10" fill="mediumseagreen" />
</svg>

Haciendo que la zona visible empiece más arriba a la izquierda y termine más abajo a la derecha, los círculos se verían completos. En este caso, hemos ampliado la zona 10 unidades por los cuatro lados, por lo que el tamaño de la zona visible pasa de 100 a 120.

<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
   width="120" height="120"   viewBox="-10 -10 120 120">
   <circle cx="0" cy="0" r="10" fill="red" />
   <circle cx="100" cy="100" r="10" fill="mediumseagreen" />
</svg>