Los artículos 03 a 06 dibujaron el mismo gráfico de línea en cuatro frameworks. Este cierra el nivel 1 de la serie sobre silverpoint con lo que esos gráficos tienen en común: un conjunto de props que acepta cualquiera de los 60 gráficos, del de barras al sunburst.

Aprenderlas una vez sirve para todos. Lo que cambia de un gráfico a otro son sus accesores, las props que dicen qué campo de cada fila dibujar (xKey y valueKey en el gráfico de línea), y sus opciones propias. Eso lo verá cada artículo del catálogo.

La misma prop en cuatro sintaxis

Las props se llaman igual en los cuatro adaptadores. Solo cambia cómo se escriben:

FrameworkTexto literalExpresión
ReactfooterLeft="Last 24 hours"height={200}
Vuefooter-left="Last 24 hours":height="200"
AngularfooterLeft="Last 24 hours"[height]="200"
Reflexfooter_left="Last 24 hours"height=200

Un número, un objeto o una variable siempre van como expresión. En Vue y Angular, si escribes height="200" sin : o sin corchetes, el gráfico recibe el texto "200" y la comprobación de tipos falla.

Las tablas de este artículo usan el nombre de React. En Vue se pasa a kebab-case (data-table), en Angular es el mismo y en Reflex se pasa a snake_case (data_table).

Los datos

PropQué hace
dataLas filas que se dibujan, un array de objetos

Sin data, el gráfico dibuja su conjunto de demostración, y con un array vacío dibuja su estado vacío, «No data». Los accesores de cada gráfico (xKey, valueKey, keys…) se ignoran con los datos de demostración; las demás props se aplican.

El estilo

PropValoresPor defecto
groundsilverpoint, cyanotypesilverpoint, o el del proveedor de la aplicación
substratecream, green, blue, ochre en silverpoint; prussian en cyanotypeEl primero del estilo base
modeink, precisionink
paletteUn objeto con los colores que sustituyesLos del estilo base

El estilo base y el sustrato son las ideas de los artículos 01 y 02: el conjunto de decisiones de dibujo y el papel preparado. mode="precision" desactiva el entintado a mano y deja los trazos exactos. Las paletas y su comprobación de contraste tienen su propio artículo.

El mismo gráfico con los cuatro sustratos de silverpoint, sin tarjeta y en cianotipia

Es el mismo gráfico seis veces. Arriba y a la izquierda abajo, los cuatro sustratos del estilo base silverpoint. En el centro abajo, con chrome="bare". A la derecha abajo, con ground="cyanotype": líneas blancas sobre azul de Prusia.

El tamaño y la tarjeta

PropQué hacePor defecto
heightEl alto del área de dibujo en píxeles160
widthUn ancho fijo en píxelesEl del contenedor
chromecard dibuja la tarjeta completa; bare, solo el área de dibujocard

Normalmente no se fija width: el gráfico mide su contenedor y se redibuja cuando cambia. Por eso un contenedor sin ancho deja el gráfico sin dibujar.

Con chrome="bare" desaparece todo el marco, el título incluido: es para cuando el gráfico va dentro de otra tarjeta o de un panel que ya tiene el suyo.

El texto de la tarjeta

PropDónde aparece
titleEl título, arriba a la izquierda
badgeUna etiqueta corta, arriba a la derecha
valueEl valor destacado, bajo el título
unitLa unidad, junto al valor
footerLeftEl pie, a la izquierda
footerRightEl pie, a la derecha

value acepta un número o un texto. Si es un número, se formatea con locale y numberFormat, igual que los ejes.

La accesibilidad

PropQué hacePor defecto
labelEl nombre accesible del gráficoEl title
descriptionLa descripción larga para lectores de pantallaUna que el gráfico genera con sus datos
dataTableLa tabla con los datos: visible, hidden o nonehidden

Cada gráfico es un SVG con su nombre y su descripción, y lleva al lado una tabla con los mismos datos. Con hidden, la tabla existe para las tecnologías de apoyo pero no se ve. Con visible, aparece debajo del gráfico. Con none, no se genera; úsalo solo si la página ya ofrece los datos de otra forma.

Los números

PropQué hace
localeEl idioma y la región de los números, como es-ES o en-US
numberFormatLas opciones de Intl.NumberFormat

Las dos se aplican a todo lo que muestra el gráfico: el valor destacado, las marcas de los ejes y la tabla de datos. Con locale="es-ES" y { notation: 'compact' }, 63844 se escribe «64 mil».

El dibujo

PropQué hacePor defecto
idUn identificador estableUno generado de forma determinista
seedLa semilla del trazo a manoDerivada de id
hatchFillCómo se rellenan las áreas: tile o per-shapetile
classNameUna clase CSS para la raíz del gráficoNinguna

El trazo a mano no es aleatorio en cada render: sale de la semilla. El mismo gráfico con el mismo id se dibuja siempre igual, en el servidor y en el navegador. Si dos gráficos con los mismos datos tienen que verse distintos, dales semillas distintas. En Reflex se escribe class_name, como en cualquier componente de Reflex.

Los eventos, onActiveChange y onSelect, también son comunes, pero tienen su propio artículo: el 11, sobre la interacción.

Todo junto

Las peticiones por hora del panel de operaciones, ahora sin pasarlas a miles, sobre el sustrato verde, con la tabla de datos visible y los números en español compacto. Los datos son filas como { hour: '12', requests: 63844 }.

En React:

<main style={{ maxWidth: 640 }}>
  <LineChart
    data={requests}
    xKey="hour"
    valueKey="requests"
    substrate="green"
    height={200}
    title="Requests per hour"
    badge="Today"
    value={63844}
    unit="requests at the peak"
    footerLeft="Last 24 hours"
    footerRight="Peak at 12:00"
    description="Requests to the web service per hour over the last 24 hours."
    dataTable="visible"
    locale="es-ES"
    numberFormat={{ notation: 'compact' }}
  />
</main>

En Vue:

<main style="max-width: 640px">
  <SpLineChart
    :data="requests"
    x-key="hour"
    value-key="requests"
    substrate="green"
    :height="200"
    title="Requests per hour"
    badge="Today"
    :value="63844"
    unit="requests at the peak"
    footer-left="Last 24 hours"
    footer-right="Peak at 12:00"
    description="Requests to the web service per hour over the last 24 hours."
    data-table="visible"
    locale="es-ES"
    :number-format="{ notation: 'compact' }"
  />
</main>

En Angular:

<main style="max-width: 640px">
  <sp-line-chart
    [data]="requests"
    xKey="hour"
    valueKey="requests"
    substrate="green"
    [height]="200"
    title="Requests per hour"
    badge="Today"
    [value]="63844"
    unit="requests at the peak"
    footerLeft="Last 24 hours"
    footerRight="Peak at 12:00"
    description="Requests to the web service per hour over the last 24 hours."
    dataTable="visible"
    locale="es-ES"
    [numberFormat]="{ notation: 'compact' }"
  />
</main>

Y en Reflex:

rx.box(
    line_chart(
        data=REQUESTS,
        x_key="hour",
        value_key="requests",
        substrate="green",
        height=200,
        title="Requests per hour",
        badge="Today",
        value=63844,
        unit="requests at the peak",
        footer_left="Last 24 hours",
        footer_right="Peak at 12:00",
        description="Requests to the web service per hour over the last 24 hours.",
        data_table="visible",
        locale="es-ES",
        number_format={"notation": "compact"},
    ),
    max_width="640px",
)

Los cuatro dibujan el mismo gráfico: «64 mil» como valor destacado, marcas como «20 mil» y «40 mil» en el eje y la tabla de 24 filas debajo. La descripción sustituye a la que el gráfico genera.

Lo que viene

Con este artículo termina el nivel 1. Ya sabes instalar silverpoint en tu framework, pasarle tus datos y configurar cualquier gráfico con las props comunes.

El nivel 2 construye un panel con estilo propio e interacción. Empieza por el 08: cómo elegir el gráfico entre las familias del catálogo. La referencia de props de la documentación tiene la lista completa de cada gráfico.