Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. MacroTokenParser.php

class MacroTokenParser

Defines a macro.

{% macro input(name, value, type, size) %} <input type="{{ type|default('text') }}" name="{{ name }}" value="{{ value|e }}" size="{{ size|default(20) }}" /> {% endmacro %}

@internal

Hierarchy

  • class \Twig\TokenParser\AbstractTokenParser implements \Twig\TokenParser\TokenParserInterface
    • class \Twig\TokenParser\MacroTokenParser extends \Twig\TokenParser\AbstractTokenParser

Expanded class hierarchy of MacroTokenParser

1 file declares its use of MacroTokenParser
CoreExtension.php in vendor/twig/twig/src/Extension/CoreExtension.php

File

vendor/twig/twig/src/TokenParser/MacroTokenParser.php, line 35

Namespace

Twig\TokenParser
View source
final class MacroTokenParser extends AbstractTokenParser {
    public function parse(Token $token) : Node {
        $lineno = $token->getLine();
        $stream = $this->parser
            ->getStream();
        $name = $stream->expect(Token::NAME_TYPE)
            ->getValue();
        $arguments = $this->parseDefinition();
        $stream->expect(Token::BLOCK_END_TYPE);
        $this->parser
            ->pushLocalScope();
        $body = $this->parser
            ->subparse([
            $this,
            'decideBlockEnd',
        ], true);
        if ($token = $stream->nextIf(Token::NAME_TYPE)) {
            $value = $token->getValue();
            if ($value != $name) {
                throw new SyntaxError(\sprintf('Expected endmacro for macro "%s" (but "%s" given).', $name, $value), $stream->getCurrent()
                    ->getLine(), $stream->getSourceContext());
            }
        }
        $this->parser
            ->popLocalScope();
        $stream->expect(Token::BLOCK_END_TYPE);
        $this->parser
            ->setMacro($name, new MacroNode($name, new BodyNode([
            $body,
        ]), $arguments, $lineno));
        return new EmptyNode($lineno);
    }
    public function decideBlockEnd(Token $token) : bool {
        return $token->test('endmacro');
    }
    public function getTag() : string {
        return 'macro';
    }
    private function parseDefinition() : ArrayExpression {
        $arguments = new ArrayExpression([], $this->parser
            ->getCurrentToken()
            ->getLine());
        $stream = $this->parser
            ->getStream();
        $stream->expect(Token::PUNCTUATION_TYPE, '(', 'A list of arguments must begin with an opening parenthesis');
        while (!$stream->test(Token::PUNCTUATION_TYPE, ')')) {
            if (count($arguments)) {
                $stream->expect(Token::PUNCTUATION_TYPE, ',', 'Arguments must be separated by a comma');
                // if the comma above was a trailing comma, early exit the argument parse loop
                if ($stream->test(Token::PUNCTUATION_TYPE, ')')) {
                    break;
                }
            }
            $token = $stream->expect(Token::NAME_TYPE, null, 'An argument must be a name');
            $name = new LocalVariable($token->getValue(), $this->parser
                ->getCurrentToken()
                ->getLine());
            if ($token = $stream->nextIf(Token::OPERATOR_TYPE, '=')) {
                $default = $this->parser
                    ->getExpressionParser()
                    ->parseExpression();
            }
            else {
                $default = new ConstantExpression(null, $this->parser
                    ->getCurrentToken()
                    ->getLine());
                $default->setAttribute('is_implicit', true);
            }
            if (!$this->checkConstantExpression($default)) {
                throw new SyntaxError('A default value for an argument must be a constant (a boolean, a string, a number, a sequence, or a mapping).', $token->getLine(), $stream->getSourceContext());
            }
            $arguments->addElement($default, $name);
        }
        $stream->expect(Token::PUNCTUATION_TYPE, ')', 'A list of arguments must be closed by a parenthesis');
        return $arguments;
    }
    // checks that the node only contains "constant" elements
    private function checkConstantExpression(Node $node) : bool {
        if (!($node instanceof ConstantExpression || $node instanceof ArrayExpression || $node instanceof NegUnary || $node instanceof PosUnary)) {
            return false;
        }
        foreach ($node as $n) {
            if (!$this->checkConstantExpression($n)) {
                return false;
            }
        }
        return true;
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
AbstractTokenParser::$parser protected property
AbstractTokenParser::setParser public function Sets the parser associated with this token parser. Overrides TokenParserInterface::setParser
MacroTokenParser::checkConstantExpression private function
MacroTokenParser::decideBlockEnd public function
MacroTokenParser::getTag public function Gets the tag name associated with this token parser. Overrides TokenParserInterface::getTag
MacroTokenParser::parse public function Parses a token and returns a node. Overrides TokenParserInterface::parse
MacroTokenParser::parseDefinition private function
RSS feed
Powered by Drupal