org.apache.xml.serialize
Class HTMLdtd
java.lang.Object
org.apache.xml.serialize.HTMLdtd
public final class HTMLdtd
extends java.lang.Object
Utility class for accessing information specific to HTML documents.
The HTML DTD is expressed as three utility function groups. Two methods
allow for checking whether an element requires an open tag on printing
(
isEmptyTag(String)
) or on parsing (
isOptionalClosing(String)
).
Two other methods translate character references from name to value and
from value to name. A small entities resource is loaded into memory the
first time any of these methods is called for fast and efficient access.
$Revision: 319808 $ $Date: 2004-02-24 18:34:05 -0500 (Tue, 24 Feb 2004) $static String | HTMLPublicId - Public identifier for HTML 4.01 (Strict) document type.
|
static String | HTMLSystemId - System identifier for HTML 4.01 (Strict) document type.
|
static String | XHTMLPublicId - Public identifier for XHTML 1.0 (Strict) document type.
|
static String | XHTMLSystemId - System identifier for XHTML 1.0 (Strict) document type.
|
static int | charFromName(String name) - Returns the value of an HTML character reference by its name.
|
static String | fromChar(int value) - Returns the name of an HTML character reference based on its character
value.
|
static boolean | isBoolean(String tagName, String attrName) - Returns true if the specified attribute is a boolean and should be
printed without the value.
|
static boolean | isClosing(String tagName, String openTag) - Returns true if the opening of one element (tagName) implies
the closing of another open element (openTag).
|
static boolean | isElementContent(String tagName) - Returns true if element is declared to have element content.
|
static boolean | isEmptyTag(String tagName) - Returns true if element is declared to be empty.
|
static boolean | isOnlyOpening(String tagName) - Returns true if element's closing tag is generally not printed.
|
static boolean | isOptionalClosing(String tagName) - Returns true if element's closing tag is optional and need not
exist.
|
static boolean | isPreserveSpace(String tagName) - Returns true if element's textual contents preserves spaces.
|
static boolean | isURI(String tagName, String attrName) - Returns true if the specified attribute it a URI and should be
escaped appropriately.
|
HTMLPublicId
public static final String HTMLPublicId
Public identifier for HTML 4.01 (Strict) document type.
HTMLSystemId
public static final String HTMLSystemId
System identifier for HTML 4.01 (Strict) document type.
XHTMLPublicId
public static final String XHTMLPublicId
Public identifier for XHTML 1.0 (Strict) document type.
XHTMLSystemId
public static final String XHTMLSystemId
System identifier for XHTML 1.0 (Strict) document type.
charFromName
public static int charFromName(String name)
Returns the value of an HTML character reference by its name. If the
reference is not found or was not defined as a character reference,
returns EOF (-1).
name
- Name of character reference
- Character code or EOF (-1)
fromChar
public static String fromChar(int value)
Returns the name of an HTML character reference based on its character
value. Only valid for entities defined from character references. If no
such character value was defined, return null.
value
- Character value of entity
isBoolean
public static boolean isBoolean(String tagName,
String attrName)
Returns true if the specified attribute is a boolean and should be
printed without the value. This applies to attributes that are true
if they exist, such as selected (OPTION/INPUT).
tagName
- The element's tag nameattrName
- The attribute's name
isClosing
public static boolean isClosing(String tagName,
String openTag)
Returns true if the opening of one element (tagName) implies
the closing of another open element (openTag). For example,
every opening LI will close the previously open LI,
and every opening BODY will close the previously open HEAD.
tagName
- The newly opened elementopenTag
- The already opened element
- True if closing tag closes opening tag
isElementContent
public static boolean isElementContent(String tagName)
Returns true if element is declared to have element content.
Whitespaces appearing inside element content will be ignored,
other text will simply report an error.
tagName
- The element tag name (upper case)
isEmptyTag
public static boolean isEmptyTag(String tagName)
Returns true if element is declared to be empty. HTML elements are
defines as empty in the DTD, not by the document syntax.
tagName
- The element tag name (upper case)
isOnlyOpening
public static boolean isOnlyOpening(String tagName)
Returns true if element's closing tag is generally not printed.
For example, LI should not print the closing tag.
tagName
- The element tag name (upper case)
- True if only opening tag should be printed
isOptionalClosing
public static boolean isOptionalClosing(String tagName)
Returns true if element's closing tag is optional and need not
exist. An error will not be reported for such elements if they
are not closed. For example, LI is most often not closed.
tagName
- The element tag name (upper case)
- True if closing tag implied
isPreserveSpace
public static boolean isPreserveSpace(String tagName)
Returns true if element's textual contents preserves spaces.
This only applies to PRE and TEXTAREA, all other HTML elements
do not preserve space.
tagName
- The element tag name (upper case)
- True if element's text content preserves spaces
isURI
public static boolean isURI(String tagName,
String attrName)
Returns true if the specified attribute it a URI and should be
escaped appropriately. In HTML URIs are escaped differently
than normal attributes.
tagName
- The element's tag nameattrName
- The attribute's name
Copyright B) 1999-2006 The Apache Software Foundation. All Rights Reserved.