class TwigNodeVisitor

Same name in other branches
  1. 9 core/lib/Drupal/Core/Template/TwigNodeVisitor.php \Drupal\Core\Template\TwigNodeVisitor
  2. 10 core/lib/Drupal/Core/Template/TwigNodeVisitor.php \Drupal\Core\Template\TwigNodeVisitor
  3. 11.x core/lib/Drupal/Core/Template/TwigNodeVisitor.php \Drupal\Core\Template\TwigNodeVisitor

Provides a Twig_NodeVisitor to change the generated parse-tree.

This is used to ensure that everything printed is wrapped via the TwigExtension->renderVar() function in order to just write {{ content }} in templates instead of having to write {{ render_var(content) }}.

Hierarchy

  • class \Drupal\Core\Template\TwigNodeVisitor extends \Drupal\Core\Template\Twig_BaseNodeVisitor

Expanded class hierarchy of TwigNodeVisitor

See also

twig_render

File

core/lib/Drupal/Core/Template/TwigNodeVisitor.php, line 14

Namespace

Drupal\Core\Template
View source
class TwigNodeVisitor extends \Twig_BaseNodeVisitor {
    
    /**
     * {@inheritdoc}
     */
    protected function doEnterNode(\Twig_Node $node, \Twig_Environment $env) {
        return $node;
    }
    
    /**
     * {@inheritdoc}
     */
    protected function doLeaveNode(\Twig_Node $node, \Twig_Environment $env) {
        // We use this to inject a call to render_var -> TwigExtension->renderVar()
        // before anything is printed.
        if ($node instanceof \Twig_Node_Print) {
            if (!empty($this->skipRenderVarFunction)) {
                // No need to add the callback, we have escape active already.
                unset($this->skipRenderVarFunction);
                return $node;
            }
            $class = get_class($node);
            $line = $node->getTemplateLine();
            return new $class(new \Twig_Node_Expression_Function('render_var', new \Twig_Node([
                $node->getNode('expr'),
            ]), $line), $line);
        }
        elseif ($node instanceof \Twig_Node_Expression_Filter) {
            $name = $node->getNode('filter')
                ->getAttribute('value');
            if ('escape' == $name || 'e' == $name) {
                // Use our own escape filter that is MarkupInterface aware.
                $node->getNode('filter')
                    ->setAttribute('value', 'drupal_escape');
                // Store that we have a filter active already that knows
                // how to deal with render arrays.
                $this->skipRenderVarFunction = TRUE;
            }
        }
        return $node;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getPriority() {
        // Just above the Optimizer, which is the normal last one.
        return 256;
    }

}

Members

Title Sort descending Modifiers Object type Summary
TwigNodeVisitor::doEnterNode protected function
TwigNodeVisitor::doLeaveNode protected function
TwigNodeVisitor::getPriority public function

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.