====== barchart() ======

Die Funktion ''barchart()'' fügt ein Balkendiagramm in einen [[:de:results:report|Ergebnisbericht]] ein.

//ReportElement// **barchart**(array //Daten//, [array //Einstellungen//])

    * //Daten// - Ein Array mit Beschriftungen als Schlüssel und numerischen Werten.
    * //Einstellungen// - Ein Array mit (optional) folgenden Schlüsseln:
      * ''%%'ref.value'%%'' -- Eine Referenzmarkierung (vertikale Linie) bei diesem Wert anzeigen
      * ''%%'ref.color'%%'' -- Farbe der Referenzmarkierung
      * ''%%'ref.label'%%'' -- Beschriftung der Referenzmarkierung
      * ''%%'color'%%'' -- Farbe für Achsen und Umrandung der Balken
      * ''%%'color.bars'%%'' -- Farbe der Balken
      * ''%%'color.values'%%'' -- Farbe der Beschriftung (Werte) innerhalb der Balken
      * ''%%'format'%%'' -- Formatierung für die Beschriftung der Balken
        * Format-String für ''sprintf()'', z.B. ''%01.2f%'' für eine Dezimalzahl mit 2 Nachkommastellen.
        * ''%tsd ...'' -- Formatierung mit Tausenderpunkt, z.B. ''%tsd €'' für ''1.234 €''.
        
        
===== Verwendung =====

Setzen Sie ''barchart()'' innerhalb einer ''box()'' ein, um die Größe des Diagramms vorzugeben.

<code php>
$data = [
  'Äpfel' => 800,
  'Birnen' => 1200,
  'Clementinen' => 1100,
  'Datteln' => 1800,
  'Erdbeeren' => 900,
  'Feigen' => 1400
];

add(
    box([
        'height' => 60,
        'width' => 120
        ],
        barchart(
            $data,
            [
                'ref.value' => 1000,
                'ref.color' => '#00CC00',
                'ref.label' => 'Referenzwert',
                'color.bars' => '#6666FF',
                'color.values' => '#FFFFFF',
            ]
        )
    )
);
</code>

{{:de:results:report:scr.report.barchart.png?nolink|Ausgabe des Balkendiagramms im PDF}}