Comment

  • The Comment interface represents the content of an XML or HTML comment, encompassing all characters between <!-- and -->.

  • Although HTML tools might implement the full SGML comment structure, this interface adheres to the XML definition of a comment.

  • The character sequence "--" (double-hyphen) is illegal within a comment according to XML 1.0, and its presence should trigger a fatal error during serialization.

  • Comment inherits from CharacterData and Node, providing methods to manipulate the comment content and its position in the DOM tree.

public interface Comment implements CharacterData

This interface inherits from CharacterData and represents the content of a comment, i.e., all the characters between the starting ' <!--' and ending '-->'. Note that this is the definition of a comment in XML, and, in practice, HTML, although some HTML tools may implement the full SGML comment structure.

No lexical check is done on the content of a comment and it is therefore possible to have the character sequence "--" (double-hyphen) in the content, which is illegal in a comment per section 2.5 of [XML 1.0]. The presence of this character sequence must generate a fatal error during serialization.

See also the Document Object Model (DOM) Level 3 Core Specification.

Inherited Constant Summary

Inherited Method Summary