Die sparkline-Anweisung wird durch die sparkline-Erweiterung bereitgestellt.

Diese Anweisung erlaubt es, sparklines in Wiki-Seiten einzubetten. Eine sparkline ist eine kleine Graphik, die so groß wie ein Wort ist und sich deshalb zur Anzeige neben Text eignet.

Beispiele

[[!sparkline  1 3 5 -3 10 0 width=40 height=16
featurepoint="4,-3,red,3" featurepoint="5,10,green,3"]]

Dies erzeugt eine einfache Liniengrafik, die aus mehreren Punkten besteht. Sie wird mit 40 Pixel Breite und 16 Pixel Höhe erzeugt. Der hohe Punkt auf der Linie hat eine grüne Markierung, der niedrige eine rote.

[[!sparkline  1 -1(red) 1 -1(red) 1 1 1 -1(red) -1(red) style=bar barwidth=2
barspacing=1 height=13]]

Dies ist ein komplexeres Beispiel, das eine Balkengrafik erzeugt. Die Balken sind 2 Pixel breit und werden durch ein Pixel getrennt; die Grafik ist 14 Pixel hoch. Die Breite für Balkengrafiken automatisch bestimmt. Punkte mit negativen Werten haben abweichend vom voreingestellten Schwarz die Farbe rot.

Verwendung

Die Form für Datenpunkte ist x,y, oder einfach nur y, wenn die x-Werte unerheblich sind. Balkengrafiken können auch (color) hinzufügen, um eine Farbe für den Balken anzugeben.

Die folgenden benannten Parameter werden erkannt. Die meisten entsprechen denen der zugrundeliegenden sparkline-Bibliothek, die in ihrem Wiki genauer beschrieben wird.

  • style - Entweder line (die Voreinstellung) oder bar.
  • width - Die Breite der Grafik in Pixeln. Wird nur für Linien-Grafiken benötigt.
  • height - Höhe des Grafen in Pixeln. Voreingestellt sind 16.
  • barwidth - Breite der Balken in einer Balkengrafik. Voreingestellt ist 1 Pixel.
  • barspacing - Abstand zwischen den Balken einer Balkengrafik in Pixeln. Voreingestellt ist 1 Pixel.
  • ymin, ymax - Minimaler und maximaler Wert für die y-Achse. Dies wird normalerweise automatisch berechnet, kann aber auch explizit angegeben werden, um mehrere verwandte Grafiken zu erhalten.

  • featurepoint - Fügt eine kreisförmige Markierung zu einer Liniengrafik hinzu, mit optionalem Text. So können bedeutsame Punkte beschriftet werden.

    Der Wert ist eine Komma-separierte Liste von Parametern, die den hervorzuhebenden Punkt angeben: x-Wert, y-Wert, Farbname, Kreisdurchmesser, Text (optional) und Platzierung des Textes (optional). Beispiel: featurepoint="3,5,blue,3"

    Verfügbare Werte für die Platzierung des Textes sind top, right, bottom und left.