com.google.template.soy.shared.restricted

Class EscapingConventions.NormalizeHtml

java.lang.Object

com.google.template.soy.shared.restricted.EscapingConventions.CrossLanguageStringXform

com.google.template.soy.shared.restricted.EscapingConventions.NormalizeHtml

All Implemented Interfaces:

Escaper

Enclosing class:

EscapingConventions

public static final class EscapingConventions.NormalizeHtml
extends EscapingConventions.CrossLanguageStringXform

A directive that encodes any HTML special characters that can appear in RCDATA unescaped but that can be escaped without changing semantics. From HTML 5:

8.2.4.3 RCDATA state

Consume the next input character:

• U+0026 AMPERSAND (&)
  Switch to the character reference in RCDATA state.
• U+003C LESS-THAN SIGN (<)
  Switch to the RCDATA less-than sign state.
• EOF
  Emit an end-of-file token.
• Anything else
  Emit the current input character as a character token.

So all HTML special characters can be escaped, except ampersand, since escaping that would lead to overescaping of legitimate HTML entities.

Field Summary

Fields

Modifier and Type	Field and Description
static EscapingConventions.NormalizeHtml	INSTANCE Implements the |normalizeHtml directive.

Method Summary

Modifier and Type	Method and Description
protected com.google.common.collect.ImmutableList<EscapingConventions.Escape>	defineEscapes() Returns the escapes used for this escaper.

Methods inherited from class com.google.template.soy.shared.restricted.EscapingConventions.CrossLanguageStringXform

escape, escape, getDirectiveName, getEscapes, getInnocuousOutput, getLangFunctionNames, getNonAsciiPrefix, getValueFilter

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

INSTANCE

public static final EscapingConventions.NormalizeHtml INSTANCE

Implements the |normalizeHtml directive.

Method Detail

defineEscapes

protected com.google.common.collect.ImmutableList<EscapingConventions.Escape> defineEscapes()

Description copied from class: EscapingConventions.CrossLanguageStringXform

Returns the escapes used for this escaper.

Specified by:

defineEscapes in class EscapingConventions.CrossLanguageStringXform