class HTML

Same name in this branch

11.1.x vendor/phpunit/phpunit/src/TextUI/Configuration/Xml/CodeCoverage/Report/Html.php \PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Html
11.1.x vendor/phpunit/phpunit/src/TextUI/Configuration/Xml/Logging/TestDox/Html.php \PHPUnit\TextUI\XmlConfiguration\Logging\TestDox\Html
11.1.x core/lib/Drupal/Core/Render/Element/Html.php \Drupal\Core\Render\Element\Html
11.1.x core/lib/Drupal/Component/Utility/Html.php \Drupal\Component\Utility\Html

Hierarchy

class \PHP_CodeSniffer\Generators\Generator
- class \PHP_CodeSniffer\Generators\HTML extends \PHP_CodeSniffer\Generators\Generator

Expanded class hierarchy of HTML

59 string references to 'HTML'

AccessDeniedSubscriber::getHandledFormats in core/modules/user/src/EventSubscriber/AccessDeniedSubscriber.php: Specifies the request formats this subscriber will respond to.
AdminRouteSubscriber::isHtmlRoute in core/modules/system/src/EventSubscriber/AdminRouteSubscriber.php: Determines whether the given route is an HTML route.
AutoEscapeTokenParser::parse in vendor/twig/twig/src/TokenParser/AutoEscapeTokenParser.php: Parses a token and returns a node.
CodeBlock::defaultConfiguration in core/modules/ckeditor5/src/Plugin/CKEditor5Plugin/CodeBlock.php
CodeBlock::defaultConfiguration in core/modules/ckeditor5/src/Plugin/CKEditor5Plugin/CodeBlock.php

... See full list

File

vendor/squizlabs/php_codesniffer/src/Generators/HTML.php, line 22

Namespace

PHP_CodeSniffer\Generators

View source

class HTML extends Generator {
    
    /**
     * Stylesheet for the HTML output.
     *
     * @var string
     */
    const STYLESHEET = '<style>
        body {
            background-color: #FFFFFF;
            font-size: 14px;
            font-family: Arial, Helvetica, sans-serif;
            color: #000000;
        }

        h1 {
            color: #666666;
            font-size: 20px;
            font-weight: bold;
            margin-top: 0px;
            background-color: #E6E7E8;
            padding: 20px;
            border: 1px solid #BBBBBB;
        }

        h2 {
            color: #00A5E3;
            font-size: 16px;
            font-weight: normal;
            margin-top: 50px;
        }

        .code-comparison {
            width: 100%;
        }

        .code-comparison td {
            border: 1px solid #CCCCCC;
        }

        .code-comparison-title, .code-comparison-code {
            font-family: Arial, Helvetica, sans-serif;
            font-size: 12px;
            color: #000000;
            vertical-align: top;
            padding: 4px;
            width: 50%;
            background-color: #F1F1F1;
            line-height: 15px;
        }

        .code-comparison-code {
            font-family: Courier;
            background-color: #F9F9F9;
        }

        .code-comparison-highlight {
            background-color: #DDF1F7;
            border: 1px solid #00A5E3;
            line-height: 15px;
        }

        .tag-line {
            text-align: center;
            width: 100%;
            margin-top: 30px;
            font-size: 12px;
        }

        .tag-line a {
            color: #000000;
        }
    </style>';
    
    /**
     * Generates the documentation for a standard.
     *
     * @return void
     * @see    processSniff()
     */
    public function generate() {
        ob_start();
        $this->printHeader();
        $this->printToc();
        foreach ($this->docFiles as $file) {
            $doc = new DOMDocument();
            $doc->load($file);
            $documentation = $doc->getElementsByTagName('documentation')
                ->item(0);
            $this->processSniff($documentation);
        }
        $this->printFooter();
        $content = ob_get_contents();
        ob_end_clean();
        echo $content;
    }
    
    //end generate()
    
    /**
     * Print the header of the HTML page.
     *
     * @return void
     */
    protected function printHeader() {
        $standard = $this->ruleset->name;
        echo '<html>' . PHP_EOL;
        echo ' <head>' . PHP_EOL;
        echo "  <title>{$standard} Coding Standards</title>" . PHP_EOL;
        echo '  ' . str_replace("\n", PHP_EOL, self::STYLESHEET) . PHP_EOL;
        echo ' </head>' . PHP_EOL;
        echo ' <body>' . PHP_EOL;
        echo "  <h1>{$standard} Coding Standards</h1>" . PHP_EOL;
    }
    
    //end printHeader()
    
    /**
     * Print the table of contents for the standard.
     *
     * The TOC is just an unordered list of bookmarks to sniffs on the page.
     *
     * @return void
     */
    protected function printToc() {
        echo '  <h2>Table of Contents</h2>' . PHP_EOL;
        echo '  <ul class="toc">' . PHP_EOL;
        foreach ($this->docFiles as $file) {
            $doc = new DOMDocument();
            $doc->load($file);
            $documentation = $doc->getElementsByTagName('documentation')
                ->item(0);
            $title = $this->getTitle($documentation);
            echo '   <li><a href="#' . str_replace(' ', '-', $title) . "\">{$title}</a></li>" . PHP_EOL;
        }
        echo '  </ul>' . PHP_EOL;
    }
    
    //end printToc()
    
    /**
     * Print the footer of the HTML page.
     *
     * @return void
     */
    protected function printFooter() {
        // Turn off errors so we don't get timezone warnings if people
        // don't have their timezone set.
        $errorLevel = error_reporting(0);
        echo '  <div class="tag-line">';
        echo 'Documentation generated on ' . date('r');
        echo ' by <a href="https://github.com/PHPCSStandards/PHP_CodeSniffer">PHP_CodeSniffer ' . Config::VERSION . '</a>';
        echo '</div>' . PHP_EOL;
        error_reporting($errorLevel);
        echo ' </body>' . PHP_EOL;
        echo '</html>' . PHP_EOL;
    }
    
    //end printFooter()
    
    /**
     * Process the documentation for a single sniff.
     *
     * @param \DOMNode $doc The DOMNode object for the sniff.
     *                      It represents the "documentation" tag in the XML
     *                      standard file.
     *
     * @return void
     */
    public function processSniff(DOMNode $doc) {
        $title = $this->getTitle($doc);
        echo '  <a name="' . str_replace(' ', '-', $title) . '" />' . PHP_EOL;
        echo "  <h2>{$title}</h2>" . PHP_EOL;
        foreach ($doc->childNodes as $node) {
            if ($node->nodeName === 'standard') {
                $this->printTextBlock($node);
            }
            else {
                if ($node->nodeName === 'code_comparison') {
                    $this->printCodeComparisonBlock($node);
                }
            }
        }
    }
    
    //end processSniff()
    
    /**
     * Print a text block found in a standard.
     *
     * @param \DOMNode $node The DOMNode object for the text block.
     *
     * @return void
     */
    protected function printTextBlock(DOMNode $node) {
        $content = trim($node->nodeValue);
        $content = htmlspecialchars($content);
        // Use the correct line endings based on the OS.
        $content = str_replace("\n", PHP_EOL, $content);
        // Allow em tags only.
        $content = str_replace('&lt;em&gt;', '<em>', $content);
        $content = str_replace('&lt;/em&gt;', '</em>', $content);
        echo "  <p class=\"text\">{$content}</p>" . PHP_EOL;
    }
    
    //end printTextBlock()
    
    /**
     * Print a code comparison block found in a standard.
     *
     * @param \DOMNode $node The DOMNode object for the code comparison block.
     *
     * @return void
     */
    protected function printCodeComparisonBlock(DOMNode $node) {
        $codeBlocks = $node->getElementsByTagName('code');
        $firstTitle = $codeBlocks->item(0)
            ->getAttribute('title');
        $first = trim($codeBlocks->item(0)->nodeValue);
        $first = str_replace('<?php', '&lt;?php', $first);
        $first = str_replace("\n", '</br>', $first);
        $first = str_replace(' ', '&nbsp;', $first);
        $first = str_replace('<em>', '<span class="code-comparison-highlight">', $first);
        $first = str_replace('</em>', '</span>', $first);
        $secondTitle = $codeBlocks->item(1)
            ->getAttribute('title');
        $second = trim($codeBlocks->item(1)->nodeValue);
        $second = str_replace('<?php', '&lt;?php', $second);
        $second = str_replace("\n", '</br>', $second);
        $second = str_replace(' ', '&nbsp;', $second);
        $second = str_replace('<em>', '<span class="code-comparison-highlight">', $second);
        $second = str_replace('</em>', '</span>', $second);
        echo '  <table class="code-comparison">' . PHP_EOL;
        echo '   <tr>' . PHP_EOL;
        echo "    <td class=\"code-comparison-title\">{$firstTitle}</td>" . PHP_EOL;
        echo "    <td class=\"code-comparison-title\">{$secondTitle}</td>" . PHP_EOL;
        echo '   </tr>' . PHP_EOL;
        echo '   <tr>' . PHP_EOL;
        echo "    <td class=\"code-comparison-code\">{$first}</td>" . PHP_EOL;
        echo "    <td class=\"code-comparison-code\">{$second}</td>" . PHP_EOL;
        echo '   </tr>' . PHP_EOL;
        echo '  </table>' . PHP_EOL;
    }
    
    //end printCodeComparisonBlock()

}

Members

Title Sort descending	Modifiers	Object type	Summary	Overriden Title
Generator::$docFiles	public	property	XML documentation files used to produce the final output.
Generator::$ruleset	public	property	The ruleset used for the run.
Generator::getTitle	protected	function	Retrieves the title of the sniff from the DOMNode supplied.
Generator::__construct	public	function	Constructs a doc generator.
HTML::generate	public	function	Generates the documentation for a standard.	Overrides Generator::generate
HTML::printCodeComparisonBlock	protected	function	Print a code comparison block found in a standard.
HTML::printFooter	protected	function	Print the footer of the HTML page.
HTML::printHeader	protected	function	Print the header of the HTML page.
HTML::printTextBlock	protected	function	Print a text block found in a standard.
HTML::printToc	protected	function	Print the table of contents for the standard.
HTML::processSniff	public	function	Process the documentation for a single sniff.	Overrides Generator::processSniff
HTML::STYLESHEET		constant	Stylesheet for the HTML output.