Html::htmlNestedHelper() - Code Metrics - Inspection of "Prefer method Html::htmlNested()." - PhpPlaisio/helper-html - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — master ( 413a15...667180 )

by P.R.
created 2022-01-14 03:52 UTC
Html::htmlNestedHelper() B

↳ Parent: Html
Complexity

Conditions	11
Paths	11
Size

Total Lines	51
Code Lines	25
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	24
CRAP Score	11
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
cc	11
eloc	25
c	1
b	0
f	0
nc	11
nop	2
dl	0
loc	51
ccs	24
cts	24
cp	1
crap	11
rs	7.3166
How to fix Long Method Complexity

<?php
declare(strict_types=1);

namespace Plaisio\Helper;

use SetBased\Exception\FallenException;
use SetBased\Helper\Cast;

/**
 * A utility class for generating HTML elements, tags, and attributes.
 */
final class Html
{
  //--------------------------------------------------------------------------------------------------------------------
  /**
   * The encoding of the generated HTML code.
   *
   * @var string
   *
   * @since 1.0.0
   * @api
   */
  public static string $encoding = 'UTF-8';

  /**
   * Counter for generating unique element IDs.
   *
   * @var int
   */
  private static int $autoId = 0;

  /**
   * Map from (some) unicode characters to ASCII characters.
   *
   * @var array
   */
  private static array $trans = ['ß' => 'sz',
                                 'à' => 'a',
                                 'á' => 'a',
                                 'â' => 'a',
                                 'ã' => 'a',
                                 'ä' => 'a',
                                 'å' => 'a',
                                 'æ' => 'ae',
                                 'ç' => 'c',
                                 'è' => 'e',
                                 'é' => 'e',
                                 'ê' => 'e',
                                 'ë' => 'e',
                                 'ì' => 'i',
                                 'í' => 'i',
                                 'î' => 'i',
                                 'ï' => 'i',
                                 'ð' => 'e',
                                 'ñ' => 'n',
                                 'ò' => 'o',
                                 'ó' => 'o',
                                 'ô' => 'o',
                                 'õ' => 'o',
                                 'ö' => 'o',
                                 '÷' => 'x',
                                 'ø' => 'o',
                                 'ù' => 'u',
                                 'ú' => 'u',
                                 'û' => 'u',
                                 'ü' => 'u',
                                 'ý' => 'y',
                                 'þ' => 'b',
                                 'ÿ' => 'y',
                                 'č' => 'c',
                                 'ł' => 'l',
                                 'š' => 's',
                                 'ů' => 'u',
                                 'ž' => 'z',
                                 'а' => 'a',
                                 'б' => 'b',
                                 'в' => 'v',
                                 'г' => 'g',
                                 'д' => 'd',
                                 'е' => 'e',
                                 'ж' => 'zh',
                                 'з' => 'z',
                                 'и' => 'i',
                                 'й' => 'i',
                                 'к' => 'k',
                                 'л' => 'l',
                                 'м' => 'm',
                                 'н' => 'n',
                                 'о' => 'o',
                                 'п' => 'p',
                                 'р' => 'r',
                                 'с' => 's',
                                 'т' => 't',
                                 'у' => 'u',
                                 'ф' => 'f',
                                 'х' => 'kh',
                                 'ц' => 'ts',
                                 'ч' => 'ch',
                                 'ш' => 'sh',
                                 'щ' => 'shch',
                                 'ъ' => '',
                                 'ы' => 'y',
                                 'ь' => '',
                                 'э' => 'e',
                                 'ю' => 'iu',
                                 'я' => 'ia',
                                 'ё' => 'e'];

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Echos the HTML code of nested elements.
   *
   * Example:
   *
   * $html = Html::echoNested([['tag'   => 'table',
   *                            'attr'  => ['class' => 'test'],
   *                            'inner' => [['tag'   => 'tr',
   *                                         'attr'  => ['id' => 'first-row'],
   *                                         'inner' => [['tag'  => 'td',
   *                                                      'text' => 'hello'],
   *                                                     ['tag'  => 'td',
   *                                                      'attr' => ['class' => 'bold'],
   *                                                      'html' => '<b>world</b>']]],
   *                                        ['tag'   => 'tr',
   *                                         'inner' => [['tag'  => 'td',
   *                                                      'text' => 'foo'],
   *                                                     ['tag'  => 'td',
   *                                                      'text' => 'bar']]],
   *                                        ['tag'   => 'tr',
   *                                         'attr'  => ['id' => 'last-row'],
   *                                         'inner' => [['tag'  => 'td',
   *                                                      'text' => 'foo'],
   *                                                     ['tag'  => 'td',
   *                                                      'text' => 'bar']]]]],
   *                           ['text' => 'The End'],
   *                           ['html' => '!']]);
   *
   * @param array|null $structure The structure of the nested elements.
   *
   * @since 3.1.0
   * @api
   * @deprecated
   */
  public static function echoNested(?array $structure): void
  {
    if ($structure!==null)
    {
      $key = array_key_first($structure);
      if (is_int($key))
      {
        // Structure is a list of elements.
        foreach ($structure as $element)
        {
          self::echoNested($element);
          /** @scrutinizer ignore-deprecated */ self::echoNested($element);
        }
      }
      elseif ($key!==null)
      {
        // Structure is an associative array.
        if (isset($structure['tag']))
        {
          // Element with content.
          if (array_key_exists('inner', $structure))
          {
            self::echoTag($structure['tag'], $structure['attr'] ?? []);
            self::echoNested($structure['inner']);
            /** @scrutinizer ignore-deprecated */ self::echoNested($structure['inner']);
            echo '</', $structure['tag'], '>';
          }
          elseif (array_key_exists('text', $structure))
          {
            self::echoElement($structure['tag'], $structure['attr'] ?? [], $structure['text']);
          }
          elseif (array_key_exists('html', $structure))
          {
            self::echoElement($structure['tag'], $structure['attr'] ?? [], $structure['html'], true);
          }
          else
          {
            self::echoVoidElement($structure['tag'], $structure['attr'] ?? []);
          }
        }
        elseif (array_key_exists('text', $structure))
        {
          echo self::txt2Html($structure['text']);
        }
        elseif (array_key_exists('html', $structure))
        {
          echo $structure['html'];
        }
        else
        {
          throw new \LogicException("Expected key 'tag', 'text', or 'html'");
        }
      }
    }
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Returns a string with proper conversion of special characters to HTML entities of an attribute of a HTML tag.
   *
   * Boolean attributes (e.g. checked, disabled and draggable, autocomplete also) are set when the value is none empty.
   *
   * @param string $name  The name of the attribute.
   * @param mixed  $value The value of the attribute.
   *
   * @return string
   *
   * @since 1.0.0
   * @api
   * @deprecated
   */
  public static function generateAttribute(string $name, $value): string
  {
    $html = '';

    switch ($name)
    {
      // Boolean attributes.
      case 'autofocus':
      case 'checked':
      case 'disabled':
      case 'hidden':
      case 'ismap':
      case 'multiple':
      case 'novalidate':
      case 'readonly':
      case 'required':
      case 'selected':
      case 'spellcheck':
        if (!empty($value))
        {
          $html = ' ';
          $html .= $name;
          $html .= '="';
          $html .= $name;
          $html .= '"';
        }
        break;

      // Annoying boolean attribute exceptions.
      case 'draggable':
        if ($value!==null)
        {
          if ($value==='auto')
          {
            $html = ' draggable="auto"';
          }
          elseif (empty($value) || $value==='false')
          {
            $html = ' draggable="false"';
          }
          else
          {
            $html = ' draggable="true"';
          }
        }
        break;

      case 'contenteditable':
        if ($value!==null)
        {
          $html = ' ';
          $html .= $name;
          $html .= (!empty($value)) ? '="true"' : '="false"';
        }
        break;

      case 'autocomplete':
        if ($value!==null)
        {
          $html = ' ';
          $html .= $name;
          $html .= (!empty($value)) ? '="on"' : '="off"';
        }
        break;

      case 'translate':
        if ($value!==null)
        {
          $html = ' ';
          $html .= $name;
          $html .= (!empty($value)) ? '="yes"' : '="no"';
        }
        break;

      case 'class' and is_array($value):
        $classes = implode(' ', self::cleanClasses($value));
        if ($classes!=='')
        {
          $html = ' class="';
          $html .= htmlspecialchars($classes, ENT_QUOTES, self::$encoding);
          $html .= '"';
        }
        break;

      default:
        if ($value!==null && $value!=='')
        {
          $html = ' ';
          $html .= htmlspecialchars($name, ENT_QUOTES, self::$encoding);
          $html .= '="';
          $html .= self::txt2Html($value);
          $html .= '"';
        }
    }

    return $html;
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Generates the HTML code for an element.
   *
   * Note: tags for void elements such as '<br/>' are not supported.
   *
   * @param string                     $tagName    The name of the tag, e.g. a, form.
   * @param array                      $attributes The attributes of the tag. Special characters in the attributes will
   *                                               be replaced with HTML entities.
   * @param bool|int|float|string|null $innerText  The inner text of the tag.
   * @param bool                       $isHtml     If set the inner text is a HTML snippet, otherwise special
   *                                               characters in the inner text will be replaced with HTML entities.
   *
   * @return string
   *
   * @since 1.0.0
   * @api
   * @deprecated
   */
  public static function generateElement(string $tagName,
                                         array  $attributes = [],
                                                $innerText = '',
                                         bool   $isHtml = false): string
  {
    $html = self::generateTag($tagName, $attributes);
    $html = /** @scrutinizer ignore-deprecated */ self::generateTag($tagName, $attributes);
    $html .= ($isHtml) ? $innerText : self::txt2Html($innerText);
    $html .= '</';
    $html .= $tagName;
    $html .= '>';

    return $html;
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Returns the HTML code of nested elements.
   *
   * Example:
   *
   * $html = Html::generateNested([['tag'   => 'table',
   *                                'attr'  => ['class' => 'test'],
   *                                'inner' => [['tag'   => 'tr',
   *                                             'attr'  => ['id' => 'first-row'],
   *                                             'inner' => [['tag'  => 'td',
   *                                                          'text' => 'hello'],
   *                                                         ['tag'  => 'td',
   *                                                          'attr' => ['class' => 'bold'],
   *                                                          'html' => '<b>world</b>']]],
   *                                            ['tag'   => 'tr',
   *                                             'inner' => [['tag'  => 'td',
   *                                                          'text' => 'foo'],
   *                                                         ['tag'  => 'td',
   *                                                          'text' => 'bar']]],
   *                                            ['tag'   => 'tr',
   *                                             'attr'  => ['id' => 'last-row'],
   *                                             'inner' => [['tag'  => 'td',
   *                                                          'text' => 'foo'],
   *                                                         ['tag'  => 'td',
   *                                                          'text' => 'bar']]]]],
   *                               ['text' => 'The End'],
   *                               ['html' => '!']]);
   *
   * @param array|null $structure The structure of the nested elements.
   *
   * @return string
   *
   * @since 1.4.0
   * @api
   * @deprecated
   */
  public static function generateNested(?array $structure): string
  {
    $html = '';
    self::htmlNestedHelper($structure, $html);

    return $html;
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Generates the HTML code for a start tag of an element.
   *
   * @param string $tagName    The name of the tag, e.g. a, form.
   * @param array  $attributes The attributes of the tag. Special characters in the attributes will be replaced with
   *                           HTML entities.
   *
   * @return string
   *
   * @since 1.0.0
   * @api
   * @deprecated
   */
  public static function generateTag(string $tagName, array $attributes = []): string
  {
    $html = '<';
    $html .= $tagName;
    foreach ($attributes as $name => $value)
    {
      $html .= self::generateAttribute($name, $value);
      $html .= /** @scrutinizer ignore-deprecated */ self::generateAttribute($name, $value);
    }
    $html .= '>';

    return $html;
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Generates the HTML code for a void element.
   *
   * Void elements are: area, base, br, col, embed, hr, img, input, keygen, link, menuitem, meta, param, source, track,
   * wbr. See <http://www.w3.org/html/wg/drafts/html/master/syntax.html#void-elements>
   *
   * @param string $tagName    The name of the tag, e.g. img, link.
   * @param array  $attributes The attributes of the tag. Special characters in the attributes will be replaced with
   *                           HTML entities.
   *
   * @return string
   *
   * @since 1.0.0
   * @api
   * @deprecated
   */
  public static function generateVoidElement(string $tagName, array $attributes = []): string
  {
    $html = '<';
    $html .= $tagName;
    foreach ($attributes as $name => $value)
    {
      $html .= self::generateAttribute($name, $value);
      $html .= /** @scrutinizer ignore-deprecated */ self::generateAttribute($name, $value);
    }
    $html .= '/>';

    return $html;
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Returns a string that can be safely used as an ID for an element. The format of the id is 'abc_<n>' where n is
   * incremented with each call of this method.
   *
   * @return string
   *
   * @since 1.0.0
   * @api
   */
  public static function getAutoId(): string
  {
    self::$autoId++;

    return 'plaisio-id-'.self::$autoId;
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Returns the HTML code of nested elements.
   *
   * Example:
   *
   * $html = Html::generateNested([['tag'   => 'table',
   *                                'attr'  => ['class' => 'test'],
   *                                'inner' => [['tag'   => 'tr',
   *                                             'attr'  => ['id' => 'first-row'],
   *                                             'inner' => [['tag'  => 'td',
   *                                                          'text' => 'hello'],
   *                                                         ['tag'  => 'td',
   *                                                          'attr' => ['class' => 'bold'],
   *                                                          'html' => '<b>world</b>']]],
   *                                            ['tag'   => 'tr',
   *                                             'inner' => [['tag'  => 'td',
   *                                                          'text' => 'foo'],
   *                                                         ['tag'  => 'td',
   *                                                          'text' => 'bar']]],
   *                                            ['tag'   => 'tr',
   *                                             'attr'  => ['id' => 'last-row'],
   *                                             'inner' => [['tag'  => 'td',
   *                                                          'text' => 'foo'],
   *                                                         ['tag'  => 'td',
   *                                                          'text' => 'bar']]]]],
   *                               ['text' => 'The End'],
   *                               ['html' => '!']]);
   *
   * @param array|null $structure The structure of the nested elements.
   *
   * @return string
   *
   * @since 3.2.0
   * @api
   */
  public static function htmlNested(?array $structure): string
  {
    $html = '';
    self::htmlNestedHelper($structure, $html);

    return $html;
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Returns a string with special characters converted to HTML entities.
   * This method is a wrapper around [htmlspecialchars](http://php.net/manual/en/function.htmlspecialchars.php).
   *
   * @param bool|int|float|string|null $value The string with optionally special characters.
   *
   * @return string
   *
   * @since 1.0.0
   * @api
   */
  public static function txt2Html($value): string
  {
    switch (true)
    {
      case is_string($value):
        return htmlspecialchars($value, ENT_QUOTES, self::$encoding);

      case is_int($value):
      case is_float($value):
      case $value===null:
        return (string)$value;

      case $value===true:
        return '1';

      case $value===false:
        return '0';

      default:
        throw new FallenException('type', is_object($value) ? get_class($value) : gettype($value));
    }
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Returns the slug of a string that can be safely used in a URL.
   *
   * @param string|null $string The string.
   *
   * @return string
   *
   * @since 1.1.0
   * @api
   */
  public static function txt2Slug(?string $string): string
  {
    if ($string===null) return '';

    return trim(preg_replace('/[^0-9a-z]+/', '-', strtr(mb_strtolower($string), self::$trans)), '-');
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Removes empty and duplicate classes from an array with classes.
   *
   * @param array $classes The classes.
   *
   * @return array
   */
  private static function cleanClasses(array $classes): array
  {
    $ret = [];

    foreach ($classes as $class)
    {
      $tmp = Cast::toManString($class, '');
      if ($tmp!=='') $ret[] = $tmp;
    }

    $ret = array_unique($ret, SORT_STRING);
    sort($ret);

    return $ret;
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Echos an attribute of an HTML tag with proper conversion of special characters to HTML entities.
   *
   * Boolean attributes (e.g. checked, disabled and draggable, autocomplete also) are set when the value is none empty.
   *
   * @param string $name  The name of the attribute.
   * @param mixed  $value The value of the attribute.
   */
  private static function echoAttribute(string $name, $value): void
  {
    switch ($name)
    {
      // Boolean attributes.
      case 'autofocus':
      case 'checked':
      case 'disabled':
      case 'hidden':
      case 'ismap':
      case 'multiple':
      case 'novalidate':
      case 'readonly':
      case 'required':
      case 'selected':
      case 'spellcheck':
        if (!empty($value))
        {
          echo ' ', $name, '="', $name, '"';
        }
        break;

      // Annoying boolean attribute exceptions.
      case 'draggable':
        if ($value!==null)
        {
          if ($value==='auto')
          {
            echo ' draggable="auto"';
          }
          elseif (empty($value) || $value==='false')
          {
            echo ' draggable="false"';
          }
          else
          {
            echo ' draggable="true"';
          }
        }
        break;

      case 'contenteditable':
        if ($value!==null)
        {
          echo ' contenteditable', (!empty($value)) ? '="true"' : '="false"';
        }
        break;

      case 'autocomplete':
        if ($value!==null)
        {
          echo ' autocomplete', (!empty($value)) ? '="on"' : '="off"';
        }
        break;

      case 'translate':
        if ($value!==null)
        {
          echo ' translate', (!empty($value)) ? '="yes"' : '="no"';
        }
        break;

      case 'class' and is_array($value):
        $classes = implode(' ', self::cleanClasses($value));
        if ($classes!=='')
        {
          echo ' class="', htmlspecialchars($classes, ENT_QUOTES, self::$encoding), '"';
        }
        break;

      default:
        if ($value!==null && $value!=='')
        {
          echo ' ', htmlspecialchars($name, ENT_QUOTES, self::$encoding), '="', self::txt2Html($value), '"';
        }
    }
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Echos the HTML code for an element.
   *
   * Note: tags for void elements such as '<br/>' are not supported.
   *
   * @param string                     $tagName    The name of the tag, e.g. a, form.
   * @param array                      $attributes The attributes of the tag. Special characters in the attributes will
   *                                               be replaced with HTML entities.
   * @param bool|int|float|string|null $innerText  The inner text of the tag.
   * @param bool                       $isHtml     If set the inner text is a HTML snippet, otherwise special
   *                                               characters in the inner text will be replaced with HTML entities.
   */
  private static function echoElement(string $tagName,
                                      array  $attributes = [],
                                             $innerText = '',
                                      bool   $isHtml = false): void
  {
    self::echoTag($tagName, $attributes);
    echo ($isHtml) ? $innerText : self::txt2Html($innerText);
    echo '</', $tagName, '>';
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Echos the HTML code for a start tag of an element.
   *
   * @param string $tagName    The name of the tag, e.g. a, form.
   * @param array  $attributes The attributes of the tag. Special characters in the attributes will be replaced with
   *                           HTML entities.
   */
  private static function echoTag(string $tagName, array $attributes): void
  {
    echo '<', $tagName;
    foreach ($attributes as $name => $value)
    {
      self::echoAttribute($name, $value);
    }
    echo '>';
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Echo the HTML code for a void element.
   *
   * Void elements are: area, base, br, col, embed, hr, img, input, keygen, link, menuitem, meta, param, source, track,
   * wbr. See <http://www.w3.org/html/wg/drafts/html/master/syntax.html#void-elements>
   *
   * @param string $tagName    The name of the tag, e.g. img, link.
   * @param array  $attributes The attributes of the tag. Special characters in the attributes will be replaced with
   *                           HTML entities.
   */
  private static function echoVoidElement(string $tagName, array $attributes): void
  {
    echo '<', $tagName;
    foreach ($attributes as $name => $value)
    {
      self::echoAttribute($name, $value);
    }
    echo '/>';
  }

  //--------------------------------------------------------------------------------------------------------------------
  /**
   * Helper method for method generateNested().
   *
   * @param array|null $structure The (nested) structure of the HTML code.
   * @param string     $html      The generated HTML code.
   */
  private static function htmlNestedHelper(?array $structure, string &$html): void
  {
    if ($structure!==null)
    {
      $key = array_key_first($structure);
      if (is_int($key))
      {
        // Structure is a list of elements.
        foreach ($structure as $element)
        {
          self::htmlNestedHelper($element, $html);
        }
      }
      elseif ($key!==null)
      {
        // Structure is an associative array.
        if (isset($structure['tag']))
        {
          // Element with content.
          if (array_key_exists('inner', $structure))
          {
            $html .= self::generateTag($structure['tag'], $structure['attr'] ?? []);
            $html .= /** @scrutinizer ignore-deprecated */ self::generateTag($structure['tag'], $structure['attr'] ?? []);
            self::htmlNestedHelper($structure['inner'], $html);
            $html .= '</';
            $html .= $structure['tag'];
            $html .= '>';
          }
          elseif (array_key_exists('text', $structure))
          {
            $html .= self::generateElement($structure['tag'], $structure['attr'] ?? [], $structure['text']);
            $html .= /** @scrutinizer ignore-deprecated */ self::generateElement($structure['tag'], $structure['attr'] ?? [], $structure['text']);
          }
          elseif (array_key_exists('html', $structure))
          {
            $html .= self::generateElement($structure['tag'], $structure['attr'] ?? [], $structure['html'], true);
            $html .= /** @scrutinizer ignore-deprecated */ self::generateElement($structure['tag'], $structure['attr'] ?? [], $structure['html'], true);
          }
          else
          {
            $html .= self::generateVoidElement($structure['tag'], $structure['attr'] ?? []);
            $html .= /** @scrutinizer ignore-deprecated */ self::generateVoidElement($structure['tag'], $structure['attr'] ?? []);
          }
        }
        elseif (array_key_exists('text', $structure))
        {
          $html .= self::txt2Html(Cast::toOptString($structure['text']));
        }
        elseif (array_key_exists('html', $structure))
        {
          $html .= $structure['html'];
        }
        else
        {
          throw new \LogicException("Expected key 'tag', 'text', or 'html'");
        }
      }
    }
  }

  //--------------------------------------------------------------------------------------------------------------------
}

//----------------------------------------------------------------------------------------------------------------------

PhpPlaisio / helper-html

Push — master ( 413a15...667180 )

Html::htmlNestedHelper() B

Complexity

Size

Duplication

Code Coverage

Importance

How to fix Long Method Complexity

Long Method

Duplication Side-by-Side

Filter issues like
