Allow renderer option tabSize < 0

In that case, it just keep tab output and will not convert it into spaces.

Signed-off-by: Jack Cherng <jfcherng@gmail.com>

Author: jfcherng

README.md

@@ -71,7 +71,7 @@ $templateOptions = [
     // the frontend HTML could use CSS "white-space: pre;" to visualize consecutive whitespaces
     // but if you want to visualize them in the backend with " ", you can set this to true
     'spacesToNbsp' => false,
-    // HTML template tab width
+    // HTML template tab width (negative = do not convert into spaces)
     'tabSize' => 4,
 ];
 

example/demo.php

@@ -46,7 +46,7 @@
                 // the frontend HTML could use CSS "white-space: pre;" to visualize consecutive whitespaces
                 // but if you want to visualize them in the backend with " ", you can set this to true
                 'spacesToNbsp' => false,
-                // HTML template tab width
+                // HTML template tab width (negative = do not convert into spaces)
                 'tabSize' => 4,
             ];
 

src/Renderer/AbstractRenderer.php

@@ -48,7 +48,7 @@ abstract class AbstractRenderer implements RendererInterface
         // template language: eng, cht, chs, jpn, ...
         // or an array which has the same keys with a language file
         'language' => 'eng',
-        // HTML template tab width
+        // HTML template tab width (negative = do not convert into spaces)
         'tabSize' => 4,
         // show "..." row in HTML templates
         'separateBlock' => true,

src/Renderer/Html/AbstractHtml.php

@@ -195,7 +195,7 @@ protected function formatLines(array $lines): array
         // unnecessary, but should improve performance if there are many lines
         $string = \implode(RendererConstant::IMPLODE_DELIMITER, $lines);
 
-        $string = $this->expandTabs($string);
+        $string = $this->expandTabs($string, $this->options['tabSize']);
         $string = $this->htmlSafe($string);
 
         if ($this->options['spacesToNbsp']) {
@@ -207,15 +207,18 @@ protected function formatLines(array $lines): array
     }
 
     /**
-     * Replace tabs in a string with a number of spaces as defined by the tabSize option.
+     * Replace tabs in a string with a number of spaces.
      *
-     * @param string $string the containing tabs to convert
+     * @param string $string  the containing tabs to convert
+     * @param int    $tabSize one tab = how many spaces, a negative does nothing
      *
      * @return string the string with the tabs converted to spaces
      */
-    protected function expandTabs(string $string): string
+    protected function expandTabs(string $string, int $tabSize = -1): string
     {
-        return \str_replace("\t", \str_repeat(' ', $this->options['tabSize']), $string);
+        return $tabSize >= 0
+            ? \str_replace("\t", \str_repeat(' ', $tabSize), $string)
+            : $string;
     }
 
     /**