function TwigExtension::escapeFilter

Same name and namespace in other branches
  1. 9 core/lib/Drupal/Core/Template/TwigExtension.php \Drupal\Core\Template\TwigExtension::escapeFilter()
  2. 8.9.x core/lib/Drupal/Core/Template/TwigExtension.php \Drupal\Core\Template\TwigExtension::escapeFilter()
  3. 10 core/lib/Drupal/Core/Template/TwigExtension.php \Drupal\Core\Template\TwigExtension::escapeFilter()

Overrides twig_escape_filter().

Replacement function for Twig's escape filter.

Parameters

\Twig\Environment $env: A Twig Environment instance.

mixed $arg: The value to be escaped.

string $strategy: The escaping strategy. Defaults to 'html'.

string $charset: The charset.

bool $autoescape: Whether the function is called by the auto-escaping feature (TRUE) or by the developer (FALSE).

Return value

string|null The escaped, rendered output, or NULL if there is no valid output.

Throws

\Exception When $arg is passed as an object which does not implement __toString(), RenderableInterface or toString().

2 calls to TwigExtension::escapeFilter()
TwigExtension::escapePlaceholder in core/lib/Drupal/Core/Template/TwigExtension.php
Provides a placeholder wrapper around ::escapeFilter.
TwigExtension::safeJoin in core/lib/Drupal/Core/Template/TwigExtension.php
Joins several strings together safely.

File

core/lib/Drupal/Core/Template/TwigExtension.php, line 413

Class

TwigExtension
A class providing Drupal Twig extensions.

Namespace

Drupal\Core\Template

Code

public function escapeFilter(Environment $env, $arg, $strategy = 'html', $charset = NULL, $autoescape = FALSE) {
    // Check for a numeric zero int or float.
    if ($arg === 0 || $arg === 0.0) {
        return 0;
    }
    // Return early for NULL and empty arrays.
    if ($arg == NULL) {
        return NULL;
    }
    $this->bubbleArgMetadata($arg);
    // Keep \Twig\Markup objects intact to support autoescaping.
    if ($autoescape && ($arg instanceof TwigMarkup || $arg instanceof MarkupInterface)) {
        return $arg;
    }
    $return = NULL;
    if (is_scalar($arg)) {
        $return = (string) $arg;
    }
    elseif (is_object($arg)) {
        if ($arg instanceof RenderableInterface) {
            $arg = $arg->toRenderable();
        }
        elseif (method_exists($arg, '__toString')) {
            $return = (string) $arg;
        }
        elseif (method_exists($arg, 'toString')) {
            $return = $arg->toString();
        }
        else {
            throw new \Exception('Object of type ' . get_class($arg) . ' cannot be printed.');
        }
    }
    // We have a string or an object converted to a string: Autoescape it!
    if (isset($return)) {
        if ($autoescape && $return instanceof MarkupInterface) {
            return $return;
        }
        // Drupal only supports the HTML escaping strategy, so provide a
        // fallback for other strategies.
        if ($strategy == 'html') {
            return Html::escape($return);
        }
        return twig_escape_filter($env, $return, $strategy, $charset, $autoescape);
    }
    // This is a normal render array, which is safe by definition, with
    // special simple cases already handled.
    // Early return if this element was pre-rendered (no need to re-render).
    if (isset($arg['#printed']) && $arg['#printed'] == TRUE && isset($arg['#markup']) && strlen($arg['#markup']) > 0) {
        return $arg['#markup'];
    }
    $arg['#printed'] = FALSE;
    return $this->renderer
        ->render($arg);
}

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