class TwigTransTokenParser

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

A class that defines the Twig 'trans' token parser for Drupal.

The token parser converts a token stream created from template source code into an Abstract Syntax Tree (AST). The AST will later be compiled into PHP code usable for runtime execution of the template.

Hierarchy

Expanded class hierarchy of TwigTransTokenParser

See also

\Twig_TokenParser

https://twig-extensions.readthedocs.io/en/latest/i18n.html

https://github.com/fabpot/Twig-extensions

File

core/lib/Drupal/Core/Template/TwigTransTokenParser.php, line 16

Namespace

Drupal\Core\Template
View source
class TwigTransTokenParser extends \Twig_TokenParser {
    
    /**
     * {@inheritdoc}
     */
    public function parse(\Twig_Token $token) {
        $lineno = $token->getLine();
        $stream = $this->parser
            ->getStream();
        $body = NULL;
        $options = NULL;
        $count = NULL;
        $plural = NULL;
        if (!$stream->test(\Twig_Token::BLOCK_END_TYPE) && $stream->test(\Twig_Token::STRING_TYPE)) {
            $body = $this->parser
                ->getExpressionParser()
                ->parseExpression();
        }
        if (!$stream->test(\Twig_Token::BLOCK_END_TYPE) && $stream->test(\Twig_Token::NAME_TYPE, 'with')) {
            $stream->next();
            $options = $this->parser
                ->getExpressionParser()
                ->parseExpression();
        }
        if (!$body) {
            $stream->expect(\Twig_Token::BLOCK_END_TYPE);
            $body = $this->parser
                ->subparse([
                $this,
                'decideForFork',
            ]);
            if ('plural' === $stream->next()
                ->getValue()) {
                $count = $this->parser
                    ->getExpressionParser()
                    ->parseExpression();
                $stream->expect(\Twig_Token::BLOCK_END_TYPE);
                $plural = $this->parser
                    ->subparse([
                    $this,
                    'decideForEnd',
                ], TRUE);
            }
        }
        $stream->expect(\Twig_Token::BLOCK_END_TYPE);
        $this->checkTransString($body, $lineno);
        $node = new TwigNodeTrans($body, $plural, $count, $options, $lineno, $this->getTag());
        return $node;
    }
    
    /**
     * Detect a 'plural' switch or the end of a 'trans' tag.
     */
    public function decideForFork($token) {
        return $token->test([
            'plural',
            'endtrans',
        ]);
    }
    
    /**
     * Detect the end of a 'trans' tag.
     */
    public function decideForEnd($token) {
        return $token->test('endtrans');
    }
    
    /**
     * {@inheritdoc}
     */
    public function getTag() {
        return 'trans';
    }
    
    /**
     * Ensure that any nodes that are parsed are only of allowed types.
     *
     * @param \Twig_Node $body
     *   The expression to check.
     * @param int $lineno
     *   The source line.
     *
     * @throws \Twig_Error_Syntax
     */
    protected function checkTransString(\Twig_Node $body, $lineno) {
        foreach ($body as $node) {
            if ($node instanceof \Twig_Node_Text || $node instanceof \Twig_Node_Print && $node->getNode('expr') instanceof \Twig_Node_Expression_Name || $node instanceof \Twig_Node_Print && $node->getNode('expr') instanceof \Twig_Node_Expression_GetAttr || $node instanceof \Twig_Node_Print && $node->getNode('expr') instanceof \Twig_Node_Expression_Filter) {
                continue;
            }
            throw new \Twig_Error_Syntax(sprintf('The text to be translated with "trans" can only contain references to simple variables'), $lineno);
        }
    }

}

Members

Title Sort descending Modifiers Object type Summary
TwigTransTokenParser::checkTransString protected function Ensure that any nodes that are parsed are only of allowed types.
TwigTransTokenParser::decideForEnd public function Detect the end of a 'trans' tag.
TwigTransTokenParser::decideForFork public function Detect a 'plural' switch or the end of a 'trans' tag.
TwigTransTokenParser::getTag public function
TwigTransTokenParser::parse public function

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