Graph widget

This widget intends to display a graph visualization of any data.

Types

There are three graph types, and they mostly share the same API. To choose one or the other, use its dedicated class:

Line graph

$widgetsContainer->addWidget(
    SharpLineGraphWidget::make('sales')
);

Bar graph

$widgetsContainer->addWidget(
    SharpBarGraphWidget::make('sales')
);

Pie graph

$widgetsContainer->addWidget(
    SharpPieGraphWidget::make('sales')
);

Attributes (setters)

setRatio

This attribute is used to define the graph ratio, which will be consistent in responsive mode. The expected format is width:height, so for instance 16:9 (the default) or 4:3.

setHeight

Used to set an arbitrary height, in px; if set the ratio is ignored.

setShowLegend

Display or not the graph legend. Default is true.

setMinimal

If true, legend and axis are hidden. Default is false.

setDisplayHorizontalAxisAsTimeline

(Line and Bar) If true, and if X axis values are valid dates, the graph will create a timeline repartition of dates, creating visual gaps between dates. Default is false.

setCurvedLines

(Line only) Display lines with curved angles. Default is true.

setHorizontal

(Bar only) Display horizontal bars instead of vertical ones. Default is false.

Data valuation

Valuation is handled by a dedicated method: $this-⁠>addGraphDataSet(string $graphWidgetKey, SharpGraphWidgetDataSet $dataSet), in the Dashboard class:

$this->addGraphDataSet(
    'sales',
    SharpGraphWidgetDataSet::make($values)
        ->setLabel('Sales')
        ->setColor('blue')
);

We use an instance of Code16\Sharp\Dashboard\Widgets\SharpGraphWidgetDataSet to handle graph data. This object is built with a $values array which must contain numeric values, keyed by a label. Example:

[
  'Pizza' => 4,
  'Hamburgers' => 12 
]

SharpGraphWidgetDataSet defines two useful setters:

• setLabel(string $label) to set the legend label
• setColor(string $color) where $color can be an HTML constant or an hexadecimal value, to set the data color.

You can chain calls to addGraphDataSet() to add multiple data sets, with different colors and labels.