com.google.template.soy.data

Enum SanitizedContent.ContentKind

java.lang.Object

java.lang.Enum<SanitizedContent.ContentKind>

com.google.template.soy.data.SanitizedContent.ContentKind

All Implemented Interfaces:

Serializable, Comparable<SanitizedContent.ContentKind>

Enclosing class:

SanitizedContent

public static enum SanitizedContent.ContentKind
extends Enum<SanitizedContent.ContentKind>

A kind of textual content.

Enum Constant Summary

Enum Constants

Enum Constant and Description
ATTRIBUTES An attribute name and value, such as dir="ltr".
CSS A CSS3 declaration, property, value or group of semicolon separated declarations.
HTML A snippet of HTML that does not start or end inside a tag, comment, entity, or DOCTYPE; and that does not contain any executable code (JS, <object>s, etc.) from a different trust domain.
JS Executable Javascript code or expression, safe for insertion in a script-tag or event handler context, known to be free of any attacker-controlled scripts.
TEXT Unsanitized plain-text content.
TRUSTED_RESOURCE_URI Resource URIs used in script sources, stylesheets, etc which are not in attacker control.
URI A properly encoded portion of a URI.

Method Summary

Modifier and Type	Method and Description
Dir	getDefaultDir()
static SanitizedContent.ContentKind	valueOf(String name) Returns the enum constant of this type with the specified name.
static SanitizedContent.ContentKind[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

HTML

public static final SanitizedContent.ContentKind HTML

A snippet of HTML that does not start or end inside a tag, comment, entity, or DOCTYPE; and that does not contain any executable code (JS, <object>s, etc.) from a different trust domain.

JS

public static final SanitizedContent.ContentKind JS

Executable Javascript code or expression, safe for insertion in a script-tag or event handler context, known to be free of any attacker-controlled scripts. This can either be side-effect-free Javascript (such as JSON) or Javascript that entirely under Google's control.

URI

public static final SanitizedContent.ContentKind URI

A properly encoded portion of a URI.

TRUSTED_RESOURCE_URI

public static final SanitizedContent.ContentKind TRUSTED_RESOURCE_URI

Resource URIs used in script sources, stylesheets, etc which are not in attacker control.

ATTRIBUTES

public static final SanitizedContent.ContentKind ATTRIBUTES

An attribute name and value, such as dir="ltr".

CSS

public static final SanitizedContent.ContentKind CSS

A CSS3 declaration, property, value or group of semicolon separated declarations.

TEXT

public static final SanitizedContent.ContentKind TEXT

Unsanitized plain-text content.

This is effectively the "null" entry of this enum, and is sometimes used to explicitly mark content that should never be used unescaped. Since any string is safe to use as text, being of ContentKind.TEXT makes no guarantees about its safety in any other context such as HTML.

In the soy type system, TEXT is equivalent to the string type.

Method Detail

values

public static SanitizedContent.ContentKind[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (SanitizedContent.ContentKind c : SanitizedContent.ContentKind.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static SanitizedContent.ContentKind valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

getDefaultDir

@Nullable
public Dir getDefaultDir()