596 lines
14 KiB
PHP
596 lines
14 KiB
PHP
<?php
|
|
|
|
namespace PhpOffice\PhpSpreadsheet\Chart;
|
|
|
|
use PhpOffice\PhpSpreadsheet\Calculation\Calculation;
|
|
use PhpOffice\PhpSpreadsheet\Calculation\Functions;
|
|
use PhpOffice\PhpSpreadsheet\Cell\Coordinate;
|
|
use PhpOffice\PhpSpreadsheet\Worksheet\Worksheet;
|
|
|
|
class DataSeriesValues extends Properties
|
|
{
|
|
const DATASERIES_TYPE_STRING = 'String';
|
|
const DATASERIES_TYPE_NUMBER = 'Number';
|
|
|
|
private const DATA_TYPE_VALUES = [
|
|
self::DATASERIES_TYPE_STRING,
|
|
self::DATASERIES_TYPE_NUMBER,
|
|
];
|
|
|
|
/**
|
|
* Series Data Type.
|
|
*
|
|
* @var string
|
|
*/
|
|
private $dataType;
|
|
|
|
/**
|
|
* Series Data Source.
|
|
*
|
|
* @var ?string
|
|
*/
|
|
private $dataSource;
|
|
|
|
/**
|
|
* Format Code.
|
|
*
|
|
* @var string
|
|
*/
|
|
private $formatCode;
|
|
|
|
/**
|
|
* Series Point Marker.
|
|
*
|
|
* @var string
|
|
*/
|
|
private $pointMarker;
|
|
|
|
/** @var ChartColor */
|
|
private $markerFillColor;
|
|
|
|
/** @var ChartColor */
|
|
private $markerBorderColor;
|
|
|
|
/**
|
|
* Series Point Size.
|
|
*
|
|
* @var int
|
|
*/
|
|
private $pointSize = 3;
|
|
|
|
/**
|
|
* Point Count (The number of datapoints in the dataseries).
|
|
*
|
|
* @var int
|
|
*/
|
|
private $pointCount = 0;
|
|
|
|
/**
|
|
* Data Values.
|
|
*
|
|
* @var mixed[]
|
|
*/
|
|
private $dataValues = [];
|
|
|
|
/**
|
|
* Fill color (can be array with colors if dataseries have custom colors).
|
|
*
|
|
* @var null|ChartColor|ChartColor[]
|
|
*/
|
|
private $fillColor;
|
|
|
|
/** @var bool */
|
|
private $scatterLines = true;
|
|
|
|
/** @var bool */
|
|
private $bubble3D = false;
|
|
|
|
/** @var ?Layout */
|
|
private $labelLayout;
|
|
|
|
/** @var TrendLine[] */
|
|
private $trendLines = [];
|
|
|
|
/**
|
|
* Create a new DataSeriesValues object.
|
|
*
|
|
* @param string $dataType
|
|
* @param string $dataSource
|
|
* @param null|mixed $formatCode
|
|
* @param int $pointCount
|
|
* @param mixed $dataValues
|
|
* @param null|mixed $marker
|
|
* @param null|ChartColor|ChartColor[]|string|string[] $fillColor
|
|
* @param string $pointSize
|
|
*/
|
|
public function __construct($dataType = self::DATASERIES_TYPE_NUMBER, $dataSource = null, $formatCode = null, $pointCount = 0, $dataValues = [], $marker = null, $fillColor = null, $pointSize = '3')
|
|
{
|
|
parent::__construct();
|
|
$this->markerFillColor = new ChartColor();
|
|
$this->markerBorderColor = new ChartColor();
|
|
$this->setDataType($dataType);
|
|
$this->dataSource = $dataSource;
|
|
$this->formatCode = $formatCode;
|
|
$this->pointCount = $pointCount;
|
|
$this->dataValues = $dataValues;
|
|
$this->pointMarker = $marker;
|
|
if ($fillColor !== null) {
|
|
$this->setFillColor($fillColor);
|
|
}
|
|
if (is_numeric($pointSize)) {
|
|
$this->pointSize = (int) $pointSize;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get Series Data Type.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getDataType()
|
|
{
|
|
return $this->dataType;
|
|
}
|
|
|
|
/**
|
|
* Set Series Data Type.
|
|
*
|
|
* @param string $dataType Datatype of this data series
|
|
* Typical values are:
|
|
* DataSeriesValues::DATASERIES_TYPE_STRING
|
|
* Normally used for axis point values
|
|
* DataSeriesValues::DATASERIES_TYPE_NUMBER
|
|
* Normally used for chart data values
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setDataType($dataType)
|
|
{
|
|
if (!in_array($dataType, self::DATA_TYPE_VALUES)) {
|
|
throw new Exception('Invalid datatype for chart data series values');
|
|
}
|
|
$this->dataType = $dataType;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get Series Data Source (formula).
|
|
*
|
|
* @return ?string
|
|
*/
|
|
public function getDataSource()
|
|
{
|
|
return $this->dataSource;
|
|
}
|
|
|
|
/**
|
|
* Set Series Data Source (formula).
|
|
*
|
|
* @param ?string $dataSource
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setDataSource($dataSource)
|
|
{
|
|
$this->dataSource = $dataSource;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get Point Marker.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getPointMarker()
|
|
{
|
|
return $this->pointMarker;
|
|
}
|
|
|
|
/**
|
|
* Set Point Marker.
|
|
*
|
|
* @param string $marker
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setPointMarker($marker)
|
|
{
|
|
$this->pointMarker = $marker;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function getMarkerFillColor(): ChartColor
|
|
{
|
|
return $this->markerFillColor;
|
|
}
|
|
|
|
public function getMarkerBorderColor(): ChartColor
|
|
{
|
|
return $this->markerBorderColor;
|
|
}
|
|
|
|
/**
|
|
* Get Point Size.
|
|
*/
|
|
public function getPointSize(): int
|
|
{
|
|
return $this->pointSize;
|
|
}
|
|
|
|
/**
|
|
* Set Point Size.
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setPointSize(int $size = 3)
|
|
{
|
|
$this->pointSize = $size;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get Series Format Code.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getFormatCode()
|
|
{
|
|
return $this->formatCode;
|
|
}
|
|
|
|
/**
|
|
* Set Series Format Code.
|
|
*
|
|
* @param string $formatCode
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setFormatCode($formatCode)
|
|
{
|
|
$this->formatCode = $formatCode;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get Series Point Count.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getPointCount()
|
|
{
|
|
return $this->pointCount;
|
|
}
|
|
|
|
/**
|
|
* Get fill color object.
|
|
*
|
|
* @return null|ChartColor|ChartColor[]
|
|
*/
|
|
public function getFillColorObject()
|
|
{
|
|
return $this->fillColor;
|
|
}
|
|
|
|
private function stringToChartColor(string $fillString): ChartColor
|
|
{
|
|
$value = $type = '';
|
|
if (substr($fillString, 0, 1) === '*') {
|
|
$type = 'schemeClr';
|
|
$value = substr($fillString, 1);
|
|
} elseif (substr($fillString, 0, 1) === '/') {
|
|
$type = 'prstClr';
|
|
$value = substr($fillString, 1);
|
|
} elseif ($fillString !== '') {
|
|
$type = 'srgbClr';
|
|
$value = $fillString;
|
|
$this->validateColor($value);
|
|
}
|
|
|
|
return new ChartColor($value, null, $type);
|
|
}
|
|
|
|
private function chartColorToString(ChartColor $chartColor): string
|
|
{
|
|
$type = (string) $chartColor->getColorProperty('type');
|
|
$value = (string) $chartColor->getColorProperty('value');
|
|
if ($type === '' || $value === '') {
|
|
return '';
|
|
}
|
|
if ($type === 'schemeClr') {
|
|
return "*$value";
|
|
}
|
|
if ($type === 'prstClr') {
|
|
return "/$value";
|
|
}
|
|
|
|
return $value;
|
|
}
|
|
|
|
/**
|
|
* Get fill color.
|
|
*
|
|
* @return string|string[] HEX color or array with HEX colors
|
|
*/
|
|
public function getFillColor()
|
|
{
|
|
if ($this->fillColor === null) {
|
|
return '';
|
|
}
|
|
if (is_array($this->fillColor)) {
|
|
$array = [];
|
|
foreach ($this->fillColor as $chartColor) {
|
|
$array[] = $this->chartColorToString($chartColor);
|
|
}
|
|
|
|
return $array;
|
|
}
|
|
|
|
return $this->chartColorToString($this->fillColor);
|
|
}
|
|
|
|
/**
|
|
* Set fill color for series.
|
|
*
|
|
* @param ChartColor|ChartColor[]|string|string[] $color HEX color or array with HEX colors
|
|
*
|
|
* @return DataSeriesValues
|
|
*/
|
|
public function setFillColor($color)
|
|
{
|
|
if (is_array($color)) {
|
|
$this->fillColor = [];
|
|
foreach ($color as $fillString) {
|
|
if ($fillString instanceof ChartColor) {
|
|
$this->fillColor[] = $fillString;
|
|
} else {
|
|
$this->fillColor[] = $this->stringToChartColor($fillString);
|
|
}
|
|
}
|
|
} elseif ($color instanceof ChartColor) {
|
|
$this->fillColor = $color;
|
|
} else {
|
|
$this->fillColor = $this->stringToChartColor($color);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Method for validating hex color.
|
|
*
|
|
* @param string $color value for color
|
|
*
|
|
* @return bool true if validation was successful
|
|
*/
|
|
private function validateColor($color)
|
|
{
|
|
if (!preg_match('/^[a-f0-9]{6}$/i', $color)) {
|
|
throw new Exception(sprintf('Invalid hex color for chart series (color: "%s")', $color));
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Get line width for series.
|
|
*
|
|
* @return null|float|int
|
|
*/
|
|
public function getLineWidth()
|
|
{
|
|
return $this->lineStyleProperties['width'];
|
|
}
|
|
|
|
/**
|
|
* Set line width for the series.
|
|
*
|
|
* @param null|float|int $width
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setLineWidth($width)
|
|
{
|
|
$this->lineStyleProperties['width'] = $width;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Identify if the Data Series is a multi-level or a simple series.
|
|
*
|
|
* @return null|bool
|
|
*/
|
|
public function isMultiLevelSeries()
|
|
{
|
|
if (!empty($this->dataValues)) {
|
|
return is_array(array_values($this->dataValues)[0]);
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Return the level count of a multi-level Data Series.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function multiLevelCount()
|
|
{
|
|
$levelCount = 0;
|
|
foreach ($this->dataValues as $dataValueSet) {
|
|
$levelCount = max($levelCount, count($dataValueSet));
|
|
}
|
|
|
|
return $levelCount;
|
|
}
|
|
|
|
/**
|
|
* Get Series Data Values.
|
|
*
|
|
* @return mixed[]
|
|
*/
|
|
public function getDataValues()
|
|
{
|
|
return $this->dataValues;
|
|
}
|
|
|
|
/**
|
|
* Get the first Series Data value.
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function getDataValue()
|
|
{
|
|
$count = count($this->dataValues);
|
|
if ($count == 0) {
|
|
return null;
|
|
} elseif ($count == 1) {
|
|
return $this->dataValues[0];
|
|
}
|
|
|
|
return $this->dataValues;
|
|
}
|
|
|
|
/**
|
|
* Set Series Data Values.
|
|
*
|
|
* @param array $dataValues
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setDataValues($dataValues)
|
|
{
|
|
$this->dataValues = Functions::flattenArray($dataValues);
|
|
$this->pointCount = count($dataValues);
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function refresh(Worksheet $worksheet, bool $flatten = true): void
|
|
{
|
|
if ($this->dataSource !== null) {
|
|
$calcEngine = Calculation::getInstance($worksheet->getParent());
|
|
$newDataValues = Calculation::unwrapResult(
|
|
$calcEngine->_calculateFormulaValue(
|
|
'=' . $this->dataSource,
|
|
null,
|
|
$worksheet->getCell('A1')
|
|
)
|
|
);
|
|
if ($flatten) {
|
|
$this->dataValues = Functions::flattenArray($newDataValues);
|
|
foreach ($this->dataValues as &$dataValue) {
|
|
if (is_string($dataValue) && !empty($dataValue) && $dataValue[0] == '#') {
|
|
$dataValue = 0.0;
|
|
}
|
|
}
|
|
unset($dataValue);
|
|
} else {
|
|
[$worksheet, $cellRange] = Worksheet::extractSheetTitle($this->dataSource, true);
|
|
$dimensions = Coordinate::rangeDimension(str_replace('$', '', $cellRange));
|
|
if (($dimensions[0] == 1) || ($dimensions[1] == 1)) {
|
|
$this->dataValues = Functions::flattenArray($newDataValues);
|
|
} else {
|
|
$newArray = array_values(array_shift(/** @scrutinizer ignore-type */ $newDataValues));
|
|
foreach ($newArray as $i => $newDataSet) {
|
|
$newArray[$i] = [$newDataSet];
|
|
}
|
|
|
|
foreach ($newDataValues as $newDataSet) {
|
|
$i = 0;
|
|
foreach ($newDataSet as $newDataVal) {
|
|
array_unshift($newArray[$i++], $newDataVal);
|
|
}
|
|
}
|
|
$this->dataValues = $newArray;
|
|
}
|
|
}
|
|
$this->pointCount = count($this->dataValues);
|
|
}
|
|
}
|
|
|
|
public function getScatterLines(): bool
|
|
{
|
|
return $this->scatterLines;
|
|
}
|
|
|
|
public function setScatterLines(bool $scatterLines): self
|
|
{
|
|
$this->scatterLines = $scatterLines;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function getBubble3D(): bool
|
|
{
|
|
return $this->bubble3D;
|
|
}
|
|
|
|
public function setBubble3D(bool $bubble3D): self
|
|
{
|
|
$this->bubble3D = $bubble3D;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Smooth Line. Must be specified for both DataSeries and DataSeriesValues.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $smoothLine;
|
|
|
|
/**
|
|
* Get Smooth Line.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getSmoothLine()
|
|
{
|
|
return $this->smoothLine;
|
|
}
|
|
|
|
/**
|
|
* Set Smooth Line.
|
|
*
|
|
* @param bool $smoothLine
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setSmoothLine($smoothLine)
|
|
{
|
|
$this->smoothLine = $smoothLine;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function getLabelLayout(): ?Layout
|
|
{
|
|
return $this->labelLayout;
|
|
}
|
|
|
|
public function setLabelLayout(?Layout $labelLayout): self
|
|
{
|
|
$this->labelLayout = $labelLayout;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function setTrendLines(array $trendLines): self
|
|
{
|
|
$this->trendLines = $trendLines;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function getTrendLines(): array
|
|
{
|
|
return $this->trendLines;
|
|
}
|
|
}
|