Un gráfico del panel de operaciones vive dentro de la página. A veces hay que sacarlo: pegarlo en un informe, en una presentación o en un correo. Este artículo de la serie sobre silverpoint añade al gráfico de tráfico un botón que lo descarga como un archivo SVG.
Cada gráfico es ya un SVG, así que exportarlo no exige dibujarlo otra vez. Lo que hay que saber es qué lleva ese SVG y qué no lleva, porque fuera de la aplicación no tiene la hoja de estilos de la página.
El manejador del gráfico
Cada gráfico expone un manejador con dos métodos:
| Método | Qué devuelve |
|---|---|
toSVGString() | El SVG del gráfico tal como está dibujado, como texto |
getGeometry() | La geometría del dibujo: viewBox, trazos, textos y áreas activas |
La forma de los objetos que devuelve getGeometry() es interna: la especificación de la librería avisa de que puede cambiar en una versión menor. Para exportar basta toSVGString().
Cómo se llega al manejador depende del framework:
| Framework | Cómo se obtiene |
|---|---|
| React | ref con el tipo ChartHandle |
| Vue | Una referencia de plantilla, InstanceType<typeof SpLineChart> |
| Angular | viewChild.required<SpLineChart>('chart'); el componente tiene los dos métodos |
| Reflex | get_svg y download_svg, que lo llaman en el navegador |
Un botón de descarga en React
El punto de partida es la aplicación de React del artículo 03, con las filas por hora en src/traffic.ts. Una función descarga un texto como archivo: crea un Blob, le da una URL temporal y hace clic en un enlace con download. src/download.ts:
export function downloadSvg(svg: string, filename: string) {
const url = URL.createObjectURL(new Blob([svg], { type: 'image/svg+xml' }));
const link = document.createElement('a');
link.href = url;
link.download = filename;
link.click();
URL.revokeObjectURL(url);
}
Y la página, src/App.tsx:
import { useRef } from 'react';
import { LineChart, type ChartHandle } from '@silverpoint/react/line-chart';
import { downloadSvg } from './download';
import { traffic } from './traffic';
export default function App() {
const chart = useRef<ChartHandle>(null);
const exportChart = () => {
const svg = chart.current?.toSVGString();
if (svg) downloadSvg(svg, 'hits-per-hour.svg');
};
return (
<main style={{ maxWidth: 640 }}>
<LineChart
ref={chart}
id="hits"
data={traffic}
xKey="hour"
valueKey="hits"
title="Hits per hour"
badge="Today"
height={200}
/>
<button type="button" onClick={exportChart}>
Download SVG
</button>
</main>
);
}
ref={chart} deja el manejador en chart.current. Al pulsar «Download SVG», el navegador guarda hits-per-hour.svg.
El problema: el archivo sale negro
Abre ese archivo en el navegador, sin la aplicación, y verás un bloque negro con letras de sistema. A la izquierda de la imagen está ese archivo; a la derecha, el mismo después del arreglo de la sección siguiente:
La razón está en lo que contiene. El SVG no lleva colores: cada trazo tiene un atributo part y los colores salen de la hoja de estilos del estilo base, @silverpoint/grounds/styles.css, a través de variables CSS. En la página esa hoja está cargada. Fuera de ella, el SVG cae en los valores por defecto del navegador: relleno negro y la fuente del sistema.
toSVGString() devuelve ese marcado tal cual, sin la hoja, en React, Vue y Angular: lo comprobé en los tres con silverpoint 0.10.1, y el archivo sale igual de negro en todos. Es así a propósito, porque es el marcado canónico del gráfico. Lo que cambió en la 0.10.0 es que la librería ya trae la función que añade la hoja (silverpoint#14).
El arreglo: la hoja de estilos dentro del SVG
La hoja de estilos del estilo base está preparada para esto: sus reglas también se aplican a un <svg> suelto, sin la página alrededor. Basta con meterla dentro del propio SVG, justo después de la etiqueta de apertura. Desde la 0.10.0 lo hace standaloneSVG, de @silverpoint/grounds. La función de descarga la llama antes de crear el Blob. src/download.ts queda así:
import { standaloneSVG } from '@silverpoint/grounds';
import groundCss from '@silverpoint/grounds/styles-text';
export function downloadSvg(svg: string, filename: string) {
const file = new Blob([standaloneSVG(svg, groundCss)], { type: 'image/svg+xml' });
const url = URL.createObjectURL(file);
const link = document.createElement('a');
link.href = url;
link.download = filename;
link.click();
URL.revokeObjectURL(url);
}
Dos detalles:
@silverpoint/grounds/styles-textes la hojastyles.csscomo un módulo de JavaScript que exporta su texto. Se importa igual en cualquier empaquetador, sin?rawni configuración. La hoja ocupa unos 11,7 kB y queda dentro del bundle de la aplicación.<![CDATA[…]]>es obligatorio, ystandaloneSVGlo pone. La hoja tiene un comentario que contiene<svg>, y sinCDATAel archivo deja de ser XML válido: el navegador muestra un error en lugar del gráfico.
App.tsx no cambia. Ahora el archivo descargado, abierto solo, se ve como la mitad derecha de la imagen. Es lo mismo que hace la herramienta render_chart del servidor MCP de silverpoint, que veremos en el artículo 28: pone la hoja del estilo base en la raíz del <svg>.
Qué contiene el SVG
Estas son las partes del archivo, abierto en un editor:
| Parte | Qué es |
|---|---|
<svg viewBox width height> | El tamaño medido en la página: 640 × 260 px aquí, 200 de área de dibujo más la tarjeta |
class y data-substrate | El estilo base y el sustrato, sp-ground-silverpoint y cream |
role="img" y aria-labelledby | El nombre accesible, que apunta a <title> y <desc> |
<title> y <desc> | El título y la descripción que el gráfico genera con sus datos |
<defs> | Los patrones del tramado |
<path part data-role> | Los trazos: el marco, la cuadrícula, la línea y sus puntos |
<text part> | Los textos: título, etiqueta y marcas de los ejes |
<style> | La hoja del estilo base, que añade standaloneSVG |
Es la tarjeta completa, con el título, la etiqueta «Today» y el marco.
Y esto es lo que no lleva:
- La tabla de datos. La tabla oculta para lectores de pantalla está fuera del SVG. El archivo conserva el nombre y la descripción.
- La fuente. Las letras piden EB Garamond. Si el equipo que abre el archivo no la tiene, usa la siguiente de la lista: Iowan Old Style o Georgia.
- La animación de entrada. Va en la hoja de estilos, así que el archivo la repite al abrirse. Si haces una captura nada más abrirlo, puede salir a medio dibujar.
Una paleta propia sí viaja. Si el gráfico tiene palette, o la recibe del proveedor, el SVG la escribe como variables en el atributo style de la raíz, y la hoja del estilo base las usa.
El tamaño del archivo es el del gráfico en la página. Si quieres otro tamaño en el archivo, fija width y height en el gráfico. Con el arreglo, el archivo de este ejemplo pasa de 4,5 kB a 16,2 kB.
En Vue
El mismo botón, con una referencia de plantilla. src/download.ts es el de React. src/App.vue:
<script setup lang="ts">
import { ref } from 'vue';
import { SpLineChart } from '@silverpoint/vue/line-chart';
import { downloadSvg } from './download';
import { traffic } from './traffic';
const chart = ref<InstanceType<typeof SpLineChart>>();
function exportChart() {
const svg = chart.value?.toSVGString();
if (svg) downloadSvg(svg, 'hits-per-hour.svg');
}
</script>
<template>
<main style="max-width: 640px">
<SpLineChart
ref="chart"
id="hits"
:data="traffic"
x-key="hour"
value-key="hits"
title="Hits per hour"
badge="Today"
:height="200"
/>
<button type="button" @click="exportChart">Download SVG</button>
</main>
</template>
ref="chart" enlaza la referencia chart con el componente, y InstanceType<typeof SpLineChart> le da el tipo con toSVGString().
En Angular
src/app/download.ts es el de React, sin cambios. @silverpoint/grounds/styles-text es un módulo de JavaScript normal: Angular lo importa sin atributos de importación, sin declaraciones de TypeScript y sin tocar angular.json, tanto con ng serve como con ng build.
Hasta la 0.9.2 había que importar styles.css con loader: 'text', declarar su tipo y desactivar el preempaquetado de ng serve, que dejaba la página en blanco (silverpoint#19). Y el componente, src/app/app.ts:
import { Component, viewChild } from '@angular/core';
import { SpLineChart } from '@silverpoint/angular/line-chart';
import { downloadSvg } from './download';
import { traffic } from './traffic';
@Component({
selector: 'app-root',
imports: [SpLineChart],
template: `
<main style="max-width: 640px">
<sp-line-chart
#chart
id="hits"
[data]="traffic"
xKey="hour"
valueKey="hits"
title="Hits per hour"
badge="Today"
[height]="200"
/>
<button type="button" (click)="exportChart()">Download SVG</button>
</main>
`,
})
export class App {
protected readonly traffic = traffic;
private readonly chart = viewChild.required<SpLineChart>('chart');
protected exportChart() {
downloadSvg(this.chart().toSVGString(), 'hits-per-hour.svg');
}
}
#chart marca el gráfico, y viewChild.required lo devuelve como SpLineChart, el componente con toSVGString() y getGeometry().
En Reflex
Reflex trae dos ayudas para esto en reflex_silverpoint_react:
| Función | Qué hace |
|---|---|
download_svg(id, filename) | Llama a toSVGString() en el navegador y descarga el archivo |
get_svg(id, handler) | Llama a toSVGString() y envía el texto a un evento del backend |
Las dos buscan el gráfico por su id, así que el gráfico necesita uno. download_svg es lo más corto:
import reflex as rx
from reflex_silverpoint_react import download_svg, line_chart
from .traffic import TRAFFIC
def index() -> rx.Component:
return rx.box(
line_chart(
id="hits",
data=TRAFFIC,
x_key="hour",
value_key="hits",
title="Hits per hour",
badge="Today",
height=200,
),
rx.el.button(
"Download SVG",
type="button",
on_click=download_svg("hits", "hits-per-hour.svg"),
),
max_width="640px",
padding="32px",
)
app = rx.App()
app.add_page(index)
Desde reflex-silverpoint-react 0.10.0, download_svg entrega el archivo completo: mete dentro del SVG, en CDATA, las reglas de silverpoint que tiene la página, y el archivo se ve con sus colores fuera de la aplicación (reflex-silverpoint-react#45). No pasa nada por el backend. get_svg entrega ese mismo SVG a un evento, para cuando quieras hacer algo con él en Python.
Hasta la 0.9.1, el archivo salía sin la hoja de estilos, negro como en los otros tres, y había que mandarlo al backend con get_svg para insertarla.
Una diferencia de tamaño: en Reflex el gráfico mide 576 px de ancho, porque max_width="640px" incluye los 32 px de padding a cada lado. El archivo sale de 576 × 260.
Los cuatro archivos se comprobaron con Chrome sin interfaz: React, Vue y Angular descargan exactamente los mismos bytes, y el de Reflex es el mismo gráfico a 576 px, con las reglas tomadas de la página. Abiertos solos, se ven como en la página; sin la hoja, se ven negros.
Sin navegador
toSVGString() necesita el gráfico montado en una página. Para generar SVG en un servidor o en un script hay dos caminos: los gráficos de servidor de React, que son el tema del artículo siguiente, y la herramienta render_chart del servidor MCP. Por dentro, los adaptadores usan funciones del paquete @silverpoint/grounds que también funcionan sin DOM, pero la especificación no las incluye en la API pública: pueden cambiar sin aviso.
Problemas comunes
- El archivo se ve negro. Le falta la hoja de estilos del estilo base. Añádela con
standaloneSVG. - El navegador muestra un error de XML al abrirlo. La hoja está dentro de
<style>sinCDATA.standaloneSVGya lo pone. toSVGStringesundefined. El manejador aún no existe: el gráfico no se ha montado, o en Reflex eliddeget_svgno coincide con el del gráfico.TS2307en Angular, o la página en blanco conng serve. Se importóstyles.cssconloader: 'text'. Importa la hoja de@silverpoint/grounds/styles-text(silverpoint#19).- El texto cambia de forma en otro equipo. El SVG no lleva la fuente. Si la forma de las letras importa, convierte el archivo a PNG o PDF en un equipo que tenga EB Garamond.
Lo que viene
El artículo 19 lleva el dibujo al servidor: los gráficos de servidor de React, el render en Vue y Angular, y por qué el mismo id da el mismo dibujo en el servidor y en el navegador.
La guía de exportación de la documentación describe el manejador de cada framework.