Direktiva sparkline je poskytována modulem sparkline.

Tato direktiva možňuje do wiki vložit sparkline (minigrafy). Sparkline je malý graf nepřevyšující velikost písma, který je uzpůsoben vložení přímo do textu

Příklady

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

Toto vytvoří jednoduchý čárový graf zobrazující několik bodů. Rozměry jsou 40 pixelů na šířku a 16 pixelů na výšku. Nejvyšší bod je označen zelenou značkou, nejnižší červenou.

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

Tento komplexnější příklad generuje sloupcový graf. Sloupce jsou široké 2 pixely a oddělené jednopixelovou mezerou. Šířka sloupcových grafů je vypočítána automaticky, na výšku má graf 13 pixelů. Body se zápornými hodnotami jsou obarveny červeně namísto výchozí černé.

Použití

Datové body mají formát „x,y“, případně jenom „y“, pokud na hodnotách x nezáleží. Sloupcové grafy mohou navíc změnit barvu sloupce přidáním „(barva)“.

Rozpoznány jsou následující parametry. Většina z nich je shodná s parametry používanými v knihovně sparkline, která je podrobně zdokumentována v její wiki.

  • style - Buď „line“ (čárový, výchozí) nebo „bar“ (sloupcový).
  • width - Šířka grafu v pixelech. Vyžadováno pouze u čárových grafů.
  • height - Výška grafu v pixelech. Výchozí hodnota je 16.
  • barwidth - Šířka sloupců u sloupcového grafu. Výchozí hodnota je 1 pixel.
  • barspacing - Mezery mezi sloupci ve sloupcovém grafu. Výchozí je 1 pixel.
  • ymin, ymax - Minimální a maximální hodnoty osy Y. Obvykle se počítají automaticky, ale pokud máte třeba několik podobných grafů, můžete je chtít zadat ve všech grafech stejné.

  • featurepoint - Do čárového grafu přidá kruhovou značku s volitelným textem. Můžete tak označit a pojmenovat význačné body.

    Hodnotou je čárkami oddělený seznam parametrů definující význačný bod: hodnota X, hodnota Y, název barvy, průměr kružnice, text (volitelný) a umístění textu (volitelné). Příklad: featurepoint="3,5,blue,3"

    Možná umístění textu jsou: „top“, „right“, „bottom“ a „left“.