Marks a section of a template to be escaped or not.
<pre> {% autoescape true %} Everything will be automatically escaped in this block {% endautoescape %}
{% autoescape false %} Everything will be outputed as is in this block {% endautoescape %}
{% autoescape true js %} Everything will be automatically escaped in this block using the js escaping strategy {% endautoescape %} </pre>
Expanded class hierarchy of Twig_TokenParser_AutoEscape
class Twig_TokenParser_AutoEscape extends Twig_TokenParser {
/**
* Parses a token and returns a node.
*
* @param Twig_Token $token A Twig_Token instance
*
* @return Twig_NodeInterface A Twig_NodeInterface instance
*/
public function parse(Twig_Token $token) {
$lineno = $token
->getLine();
$stream = $this->parser
->getStream();
if ($stream
->test(Twig_Token::BLOCK_END_TYPE)) {
$value = 'html';
}
else {
$expr = $this->parser
->getExpressionParser()
->parseExpression();
if (!$expr instanceof Twig_Node_Expression_Constant) {
throw new Twig_Error_Syntax('An escaping strategy must be a string or a Boolean.', $stream
->getCurrent()
->getLine(), $stream
->getFilename());
}
$value = $expr
->getAttribute('value');
$compat = true === $value || false === $value;
if (true === $value) {
$value = 'html';
}
if ($compat && $stream
->test(Twig_Token::NAME_TYPE)) {
if (false === $value) {
throw new Twig_Error_Syntax('Unexpected escaping strategy as you set autoescaping to false.', $stream
->getCurrent()
->getLine(), $stream
->getFilename());
}
$value = $stream
->next()
->getValue();
}
}
$stream
->expect(Twig_Token::BLOCK_END_TYPE);
$body = $this->parser
->subparse(array(
$this,
'decideBlockEnd',
), true);
$stream
->expect(Twig_Token::BLOCK_END_TYPE);
return new Twig_Node_AutoEscape($value, $body, $lineno, $this
->getTag());
}
public function decideBlockEnd(Twig_Token $token) {
return $token
->test('endautoescape');
}
/**
* Gets the tag name associated with this token parser.
*
* @return string The tag name
*/
public function getTag() {
return 'autoescape';
}
}
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
Twig_TokenParser:: |
protected | property | ||
Twig_TokenParser:: |
public | function |
Sets the parser associated with this token parser Overrides Twig_TokenParserInterface:: |
|
Twig_TokenParser_AutoEscape:: |
public | function | ||
Twig_TokenParser_AutoEscape:: |
public | function |
Gets the tag name associated with this token parser. Overrides Twig_TokenParserInterface:: |
|
Twig_TokenParser_AutoEscape:: |
public | function |
Parses a token and returns a node. Overrides Twig_TokenParserInterface:: |