From 8fa27d76a91cee73b41c9ca71d13d27e7a910262 Mon Sep 17 00:00:00 2001
From: Tom <tom@gatherit.co.uk>
Date: Tue, 16 Dec 2025 15:53:46 +0000
Subject: [PATCH 1/3] Added support and options for handling null values in
 Charts

---
 src/PhpWord/Style/Chart.php | 96 ++++++++++++++++++++++++++++---------
 1 file changed, 74 insertions(+), 22 deletions(-)

diff --git a/src/PhpWord/Style/Chart.php b/src/PhpWord/Style/Chart.php
index 3773565ce9..ec29ec98ba 100644
--- a/src/PhpWord/Style/Chart.php
+++ b/src/PhpWord/Style/Chart.php
@@ -73,7 +73,7 @@ class Chart extends AbstractStyle
      *
      * @var string
      */
-    private $legendPosition = 'r';
+    private $legendPosition = "r";
 
     /**
      * A list of display options for data labels.
@@ -81,13 +81,13 @@ class Chart extends AbstractStyle
      * @var array
      */
     private $dataLabelOptions = [
-        'showVal' => true, // value
-        'showCatName' => true, // category name
-        'showLegendKey' => false, //show the cart legend
-        'showSerName' => false, // series name
-        'showPercent' => false,
-        'showLeaderLines' => false,
-        'showBubbleSize' => false,
+        "showVal" => true, // value
+        "showCatName" => true, // category name
+        "showLegendKey" => false, //show the cart legend
+        "showSerName" => false, // series name
+        "showPercent" => false,
+        "showLeaderLines" => false,
+        "showBubbleSize" => false,
     ];
 
     /**
@@ -98,7 +98,7 @@ class Chart extends AbstractStyle
      *
      * @var string
      */
-    private $categoryLabelPosition = 'nextTo';
+    private $categoryLabelPosition = "nextTo";
 
     /**
      * A string that tells the writer where to write chart labels or to skip
@@ -108,7 +108,7 @@ class Chart extends AbstractStyle
      *
      * @var string
      */
-    private $valueLabelPosition = 'nextTo';
+    private $valueLabelPosition = "nextTo";
 
     /**
      * @var string
@@ -126,7 +126,7 @@ class Chart extends AbstractStyle
      *
      * @var string
      */
-    private $majorTickMarkPos = 'none';
+    private $majorTickMarkPos = "none";
 
     /**
      * Show labels for axis.
@@ -149,6 +149,14 @@ class Chart extends AbstractStyle
      */
     private $gridX = false;
 
+    /**
+     * How to display blank values (nulls) in series data.
+     * Options: 'gap' (break line), 'span' (connect line), 'zero' (plot as zero)
+     *
+     * @var string
+     */
+    private $displayBlanksAs = "gap"; // Default to gap
+
     /**
      * Create a new instance.
      *
@@ -327,10 +335,14 @@ public function getLegendPosition()
      *
      * @return self
      */
-    public function setLegendPosition($legendPosition = 'r')
+    public function setLegendPosition($legendPosition = "r")
     {
-        $enum = ['r', 'b', 't', 'l', 'tr'];
-        $this->legendPosition = $this->setEnumVal($legendPosition, $enum, $this->legendPosition);
+        $enum = ["r", "b", "t", "l", "tr"];
+        $this->legendPosition = $this->setEnumVal(
+            $legendPosition,
+            $enum,
+            $this->legendPosition,
+        );
 
         return $this;
     }
@@ -354,7 +366,10 @@ public function showAxisLabels()
      */
     public function setShowAxisLabels($value = true)
     {
-        $this->showAxisLabels = $this->setBoolVal($value, $this->showAxisLabels);
+        $this->showAxisLabels = $this->setBoolVal(
+            $value,
+            $this->showAxisLabels,
+        );
 
         return $this;
     }
@@ -381,7 +396,7 @@ public function setDataLabelOptions($values = []): void
             if (isset($values[$option])) {
                 $this->dataLabelOptions[$option] = $this->setBoolVal(
                     $values[$option],
-                    $this->dataLabelOptions[$option]
+                    $this->dataLabelOptions[$option],
                 );
             }
         }
@@ -434,8 +449,12 @@ public function getCategoryLabelPosition()
      */
     public function setCategoryLabelPosition($labelPosition)
     {
-        $enum = ['nextTo', 'low', 'high'];
-        $this->categoryLabelPosition = $this->setEnumVal($labelPosition, $enum, $this->categoryLabelPosition);
+        $enum = ["nextTo", "low", "high"];
+        $this->categoryLabelPosition = $this->setEnumVal(
+            $labelPosition,
+            $enum,
+            $this->categoryLabelPosition,
+        );
 
         return $this;
     }
@@ -459,8 +478,12 @@ public function getValueLabelPosition()
      */
     public function setValueLabelPosition(string $labelPosition)
     {
-        $enum = ['nextTo', 'low', 'high'];
-        $this->valueLabelPosition = $this->setEnumVal($labelPosition, $enum, $this->valueLabelPosition);
+        $enum = ["nextTo", "low", "high"];
+        $this->valueLabelPosition = $this->setEnumVal(
+            $labelPosition,
+            $enum,
+            $this->valueLabelPosition,
+        );
 
         return $this;
     }
@@ -521,8 +544,12 @@ public function getMajorTickPosition()
      */
     public function setMajorTickPosition($position): void
     {
-        $enum = ['in', 'out', 'cross', 'none'];
-        $this->majorTickMarkPos = $this->setEnumVal($position, $enum, $this->majorTickMarkPos);
+        $enum = ["in", "out", "cross", "none"];
+        $this->majorTickMarkPos = $this->setEnumVal(
+            $position,
+            $enum,
+            $this->majorTickMarkPos,
+        );
     }
 
     /**
@@ -548,4 +575,29 @@ public function setShowGridX($value = true)
 
         return $this;
     }
+
+    /**
+     * Set display blanks as option.
+     *
+     * @param string $value 'gap', 'span', or 'zero'
+     * @return self
+     */
+    public function setDisplayBlanksAs($value)
+    {
+        $validValues = ["gap", "span", "zero"];
+        if (in_array($value, $validValues)) {
+            $this->displayBlanksAs = $value;
+        }
+        return $this;
+    }
+
+    /**
+     * Get display blanks as option.
+     *
+     * @return string
+     */
+    public function getDisplayBlanksAs()
+    {
+        return $this->displayBlanksAs;
+    }
 }

From 4d7443bf20e9f548d680e5acdbc35fe465b18c91 Mon Sep 17 00:00:00 2001
From: Tom <tom@gatherit.co.uk>
Date: Tue, 16 Dec 2025 17:43:35 +0000
Subject: [PATCH 2/3] Tests and documentation updated

---
 docs/usage/styles/chart.md                    |   3 +-
 header-footer-images-test-result.docx         | Bin 0 -> 19393 bytes
 src/PhpWord/Style/Chart.php                   |  71 ++++++----------
 src/PhpWord/Writer/Word2007/Part/Chart.php    |  26 ++++--
 .../Word2007/Part/ChartNullHandlingTest.php   |  77 ++++++++++++++++++
 tests/PhpWordTests/_files/tcpdf.pdf           | Bin
 tests/PhpWordTests/_files/temp.epub           | Bin 0 -> 136 bytes
 unknown.file                                  |   0
 8 files changed, 126 insertions(+), 51 deletions(-)
 create mode 100644 header-footer-images-test-result.docx
 create mode 100644 tests/PhpWordTests/Writer/Word2007/Part/ChartNullHandlingTest.php
 create mode 100644 tests/PhpWordTests/_files/tcpdf.pdf
 create mode 100644 tests/PhpWordTests/_files/temp.epub
 create mode 100644 unknown.file

diff --git a/docs/usage/styles/chart.md b/docs/usage/styles/chart.md
index f297718d24..99e4016136 100644
--- a/docs/usage/styles/chart.md
+++ b/docs/usage/styles/chart.md
@@ -16,4 +16,5 @@ Available Chart style options:
 - ``majorTickMarkPos``. The position for major tick marks, *in*, *out*, *cross*, *none* (default).
 - ``showAxisLabels``. Show labels for axis, *true* or *false*.
 - ``gridX``. Show Gridlines for X-Axis, *true* or *false*.
-- ``gridY``. Show Gridlines for Y-Axis, *true* or *false*.
\ No newline at end of file
+- ``gridY``. Show Gridlines for Y-Axis, *true* or *false*.
+- ``setDisplayBlanksAs``. How to display null values, *zero*, *span*, *gap* (default).
diff --git a/header-footer-images-test-result.docx b/header-footer-images-test-result.docx
new file mode 100644
index 0000000000000000000000000000000000000000..a855345141c0a8fe10638bde9213af4a452ed1e0
GIT binary patch
literal 19393
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
U3gZ9(4B%fFPzy^U{`1xU0oTOKt^fc4

literal 0
HcmV?d00001

diff --git a/src/PhpWord/Style/Chart.php b/src/PhpWord/Style/Chart.php
index ec29ec98ba..bb19d95999 100644
--- a/src/PhpWord/Style/Chart.php
+++ b/src/PhpWord/Style/Chart.php
@@ -73,7 +73,7 @@ class Chart extends AbstractStyle
      *
      * @var string
      */
-    private $legendPosition = "r";
+    private $legendPosition = 'r';
 
     /**
      * A list of display options for data labels.
@@ -81,13 +81,13 @@ class Chart extends AbstractStyle
      * @var array
      */
     private $dataLabelOptions = [
-        "showVal" => true, // value
-        "showCatName" => true, // category name
-        "showLegendKey" => false, //show the cart legend
-        "showSerName" => false, // series name
-        "showPercent" => false,
-        "showLeaderLines" => false,
-        "showBubbleSize" => false,
+        'showVal' => true, // value
+        'showCatName' => true, // category name
+        'showLegendKey' => false, //show the cart legend
+        'showSerName' => false, // series name
+        'showPercent' => false,
+        'showLeaderLines' => false,
+        'showBubbleSize' => false,
     ];
 
     /**
@@ -98,7 +98,7 @@ class Chart extends AbstractStyle
      *
      * @var string
      */
-    private $categoryLabelPosition = "nextTo";
+    private $categoryLabelPosition = 'nextTo';
 
     /**
      * A string that tells the writer where to write chart labels or to skip
@@ -108,7 +108,7 @@ class Chart extends AbstractStyle
      *
      * @var string
      */
-    private $valueLabelPosition = "nextTo";
+    private $valueLabelPosition = 'nextTo';
 
     /**
      * @var string
@@ -126,7 +126,7 @@ class Chart extends AbstractStyle
      *
      * @var string
      */
-    private $majorTickMarkPos = "none";
+    private $majorTickMarkPos = 'none';
 
     /**
      * Show labels for axis.
@@ -151,11 +151,11 @@ class Chart extends AbstractStyle
 
     /**
      * How to display blank values (nulls) in series data.
-     * Options: 'gap' (break line), 'span' (connect line), 'zero' (plot as zero)
+     * Options: 'gap' (break line), 'span' (connect line), 'zero' (plot as zero).
      *
      * @var string
      */
-    private $displayBlanksAs = "gap"; // Default to gap
+    private $displayBlanksAs = 'gap'; // Default to gap
 
     /**
      * Create a new instance.
@@ -335,14 +335,10 @@ public function getLegendPosition()
      *
      * @return self
      */
-    public function setLegendPosition($legendPosition = "r")
+    public function setLegendPosition($legendPosition = 'r')
     {
-        $enum = ["r", "b", "t", "l", "tr"];
-        $this->legendPosition = $this->setEnumVal(
-            $legendPosition,
-            $enum,
-            $this->legendPosition,
-        );
+        $enum = ['r', 'b', 't', 'l', 'tr'];
+        $this->legendPosition = $this->setEnumVal($legendPosition, $enum, $this->legendPosition);
 
         return $this;
     }
@@ -366,10 +362,7 @@ public function showAxisLabels()
      */
     public function setShowAxisLabels($value = true)
     {
-        $this->showAxisLabels = $this->setBoolVal(
-            $value,
-            $this->showAxisLabels,
-        );
+        $this->showAxisLabels = $this->setBoolVal($value, $this->showAxisLabels);
 
         return $this;
     }
@@ -396,7 +389,7 @@ public function setDataLabelOptions($values = []): void
             if (isset($values[$option])) {
                 $this->dataLabelOptions[$option] = $this->setBoolVal(
                     $values[$option],
-                    $this->dataLabelOptions[$option],
+                    $this->dataLabelOptions[$option]
                 );
             }
         }
@@ -449,12 +442,8 @@ public function getCategoryLabelPosition()
      */
     public function setCategoryLabelPosition($labelPosition)
     {
-        $enum = ["nextTo", "low", "high"];
-        $this->categoryLabelPosition = $this->setEnumVal(
-            $labelPosition,
-            $enum,
-            $this->categoryLabelPosition,
-        );
+        $enum = ['nextTo', 'low', 'high'];
+        $this->categoryLabelPosition = $this->setEnumVal($labelPosition, $enum, $this->categoryLabelPosition);
 
         return $this;
     }
@@ -478,12 +467,8 @@ public function getValueLabelPosition()
      */
     public function setValueLabelPosition(string $labelPosition)
     {
-        $enum = ["nextTo", "low", "high"];
-        $this->valueLabelPosition = $this->setEnumVal(
-            $labelPosition,
-            $enum,
-            $this->valueLabelPosition,
-        );
+        $enum = ['nextTo', 'low', 'high'];
+        $this->valueLabelPosition = $this->setEnumVal($labelPosition, $enum, $this->valueLabelPosition);
 
         return $this;
     }
@@ -544,12 +529,8 @@ public function getMajorTickPosition()
      */
     public function setMajorTickPosition($position): void
     {
-        $enum = ["in", "out", "cross", "none"];
-        $this->majorTickMarkPos = $this->setEnumVal(
-            $position,
-            $enum,
-            $this->majorTickMarkPos,
-        );
+        $enum = ['in', 'out', 'cross', 'none'];
+        $this->majorTickMarkPos = $this->setEnumVal($position, $enum, $this->majorTickMarkPos);
     }
 
     /**
@@ -580,14 +561,16 @@ public function setShowGridX($value = true)
      * Set display blanks as option.
      *
      * @param string $value 'gap', 'span', or 'zero'
+     *
      * @return self
      */
     public function setDisplayBlanksAs($value)
     {
-        $validValues = ["gap", "span", "zero"];
+        $validValues = ['gap', 'span', 'zero'];
         if (in_array($value, $validValues)) {
             $this->displayBlanksAs = $value;
         }
+
         return $this;
     }
 
diff --git a/src/PhpWord/Writer/Word2007/Part/Chart.php b/src/PhpWord/Writer/Word2007/Part/Chart.php
index 65e686ebad..445c8272fc 100644
--- a/src/PhpWord/Writer/Word2007/Part/Chart.php
+++ b/src/PhpWord/Writer/Word2007/Part/Chart.php
@@ -205,6 +205,16 @@ private function writePlotArea(XMLWriter $xmlWriter): void
         }
 
         $xmlWriter->endElement(); // c:plotArea
+
+        $xmlWriter->startElement('c:plotVisOnly');
+        $xmlWriter->writeAttribute('val', '1');
+        $xmlWriter->endElement();
+
+        $displayBlanksAs = method_exists($style, 'getDisplayBlanksAs') ? $style->getDisplayBlanksAs() : 'gap';
+
+        $xmlWriter->startElement('c:dispBlanksAs');
+        $xmlWriter->writeAttribute('val', $displayBlanksAs);
+        $xmlWriter->endElement();
     }
 
     /**
@@ -314,13 +324,17 @@ private function writeSeriesItem(XMLWriter $xmlWriter, $type, $values): void
         foreach ($values as $value) {
             $xmlWriter->startElement('c:pt');
             $xmlWriter->writeAttribute('idx', $index);
-            if (\PhpOffice\PhpWord\Settings::isOutputEscapingEnabled()) {
-                $xmlWriter->writeElement('c:v', $value);
-            } else {
-                $xmlWriter->startElement('c:v');
-                $xmlWriter->writeRaw($value);
-                $xmlWriter->endElement(); // c:v
+
+            if ($value !== null) {
+                if (\PhpOffice\PhpWord\Settings::isOutputEscapingEnabled()) {
+                    $xmlWriter->writeElement('c:v', $value);
+                } else {
+                    $xmlWriter->startElement('c:v');
+                    $xmlWriter->writeRaw($value);
+                    $xmlWriter->endElement(); // c:v
+                }
             }
+
             $xmlWriter->endElement(); // c:pt
             ++$index;
         }
diff --git a/tests/PhpWordTests/Writer/Word2007/Part/ChartNullHandlingTest.php b/tests/PhpWordTests/Writer/Word2007/Part/ChartNullHandlingTest.php
new file mode 100644
index 0000000000..cf8bbb7b77
--- /dev/null
+++ b/tests/PhpWordTests/Writer/Word2007/Part/ChartNullHandlingTest.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace PhpOffice\PhpWord\Tests\Writer\Word2007\Part;
+
+use PhpOffice\PhpWord\Element\Chart;
+use PhpOffice\PhpWord\Shared\XMLWriter;
+use PhpOffice\PhpWord\Writer\Word2007\Part\Chart as ChartWriter;
+use PHPUnit\Framework\TestCase;
+use ReflectionClass;
+
+class ChartNullHandlingTest extends TestCase
+{
+    /**
+     * Test that the Style class correctly sets/gets the property.
+     */
+    public function testSetGetDisplayBlanksAs(): void
+    {
+        // Note: Pass empty arrays for categories/values to avoid constructor errors
+        $chart = new Chart('line', [], []);
+        $style = $chart->getStyle();
+
+        // 1. Default should be 'gap'
+        self::assertEquals('gap', $style->getDisplayBlanksAs());
+
+        // 2. Test setting 'span'
+        $style->setDisplayBlanksAs('span');
+        self::assertEquals('span', $style->getDisplayBlanksAs());
+
+        // 3. Test invalid value (should remain 'span')
+        $style->setDisplayBlanksAs('invalid_option');
+        self::assertEquals('span', $style->getDisplayBlanksAs());
+    }
+
+    public function testWriteChartHandlesNullsAndGaps(): void
+    {
+        // 1. Setup Data
+        $categories = ['Jan', 'Feb', 'Mar'];
+        $values = [10, null, 20];
+        $seriesNames = ['My Series']; // <--- ADD THIS
+
+        // 2. Create Chart with Series Name
+        $chart = new Chart('line', $categories, $values, $seriesNames);
+        $chart->getStyle()->setDisplayBlanksAs('gap');
+
+        // 3. Setup Writer
+        $xmlWriter = new XMLWriter();
+        $chartWriter = new ChartWriter();
+
+        // Mock the parent writer
+        $chartWriter->setParentWriter($this->createMock(\PhpOffice\PhpWord\Writer\Word2007::class));
+
+        // 4. Inject Chart into Writer
+        $reflectionWriter = new ReflectionClass(ChartWriter::class);
+        $elementProperty = $reflectionWriter->getProperty('element');
+        $elementProperty->setAccessible(true);
+        $elementProperty->setValue($chartWriter, $chart);
+
+        // 5. Run
+        $method = $reflectionWriter->getMethod('writeChart');
+        $method->setAccessible(true);
+        $method->invokeArgs($chartWriter, [$xmlWriter]);
+
+        $xml = $xmlWriter->getData();
+
+        // --- ASSERTIONS ---
+        self::assertStringContainsString('<c:dispBlanksAs val="gap"/>', $xml);
+
+        // Check for the empty point (null value)
+        self::assertMatchesRegularExpression('/<c:pt idx="1"\s*\/?>/', $xml);
+
+        // Ensure no zero value was written for index 1
+        self::assertDoesNotMatchRegularExpression(
+            '/<c:pt idx="1"[^>]*>.*?<c:v>0<\/c:v>.*?<\/c:pt>/s',
+            $xml
+        );
+    }
+}
diff --git a/tests/PhpWordTests/_files/tcpdf.pdf b/tests/PhpWordTests/_files/tcpdf.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/tests/PhpWordTests/_files/temp.epub b/tests/PhpWordTests/_files/temp.epub
new file mode 100644
index 0000000000000000000000000000000000000000..f8d3b65aa647437615233b414e66bb7c0c48504b
GIT binary patch
literal 136
zcmWIWW@h1HU|`^2i0PdWou9Z`M-0dl0gEs&<YwlkmQ)s`dh2MMIO*f3bMnmj%l^6=
ozL(aW(qUi-@MdHZVZf~$Xb2L3nHAv8$_5f<1VS?)Z39*V08CmMRR910

literal 0
HcmV?d00001

diff --git a/unknown.file b/unknown.file
new file mode 100644
index 0000000000..e69de29bb2

From 3694d870637e4b11458ad97961de54c8c5513827 Mon Sep 17 00:00:00 2001
From: Tom <tom@gatherit.co.uk>
Date: Tue, 16 Dec 2025 17:46:51 +0000
Subject: [PATCH 3/3] Updated changelog

---
 docs/changes/1.x/1.5.0.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/changes/1.x/1.5.0.md b/docs/changes/1.x/1.5.0.md
index b96865bada..d2240e7ef1 100644
--- a/docs/changes/1.x/1.5.0.md
+++ b/docs/changes/1.x/1.5.0.md
@@ -4,6 +4,8 @@
 
 ## Enhancements
 
+- adds the setDisplayBlanksAs option to the Chart Style, allowing users to handle null values in series data. You can choose 'gap' (break line), 'span' (connect line), or 'zero' (display nulls as zero, as it the current default). 
+
 ### Bug fixes
 
 - Set writeAttribute return type by [@radarhere](https://github.com/radarhere) fixing [#2204](https://github.com/PHPOffice/PHPWord/issues/2204) in [#2776](https://github.com/PHPOffice/PHPWord/pull/2776)
@@ -16,4 +18,4 @@
 
 ### BC Breaks
 
-### Notes
\ No newline at end of file
+### Notes