Conventions

[30]

[32] An InterfaceName object refers to an object that implements InterfaceName interface. Note that the object might also implement other interfaces than InterfaceName. However, unless explicitly specified, the term Text object does not refer to a CDATASection object though the CDATASection interface extends the Text interface.

[33] When a CONSTANT_NAME ExceptionInterfaceName is said to be thrown, an implementation MUST throw an exception object that implements the ExceptionInterfaceName interface and whose code attribute is set to the value of CONSTANT_NAME.

[34] Algorithms shown in this document does not intend to constraint the way to implement that feature. Implementations are always free to implement that feature in any way as long as that has the same effect as the normative algorithm.

New interfaces

• DOM XML Document Type Definition module
  • DocumentXDoctype
  • DocumentTypeDefinition
  • ElementTypeDefinition
  • AttributeDefinition
• SerialWalker
• Atom DOM

Extensions to existing interfaces

• manakai DOM Node Extensions
• manakai DOM Document Extensions

Backward compatibility

[64] It MUST implement the definitions in the DOM Standard but commented out with markers "AttrExodus" or "NodeExodus". DOM

partial interface Node {
  attribute DOMString prefix;
};

[66] On setting, the prefix attribute of the Node interface MUST run these steps:

[78] For the isEqualNode method of the Node interface, the following condition MUST be applied as well as the other conditions: If the nodes are Attr objects, their local name, namespace, and value are equal respectively.

[81] In the "clone" steps, when node is an Attr node, or node is an Element node and its attribute list is copied, namespace prefix, namespace, local name, and value of attributes MUST be copied.

[89] The isSupported method of the Node interface MUST return true.

[90] If a non-null value is set to the handler argument to the setUserData method of the Node interface, a "NotSupportedError" MAY be thrown.

[150] When the value attribute or the manakaiAppendText method of the Attr object set the value of the attribute, at the end of the steps, attribute is set and attribute is changed if there is non-null owner element for the context object.

[151] When the Attr node is adopted, if its owner element is not null, just after the node's owner element is set to null but before the node document is set to the new value, attribute is removed.

[152] When an element's id attribute is set to the empty string, unset the element's ID.

[153] When an element's class attribute is set to the empty string, set the element's classes to the empty list.

Extension to the Element interface

[54] Manakai's Element objects implement the innerHTML attribute of the HTMLElement interface.

partial interface Element {
  readonly attribute DOMString manakaiTagName;
};

partial interface Element {
  readonly attribute DOMString[] manakaiIds;
};

partial interface HTMLElement {
  HTMLPropertiesCollection manakaiGetProperties();
};

Extension to the NodeList and the NamedNodeMap interfaces

This attribute is obsolete.

[8] The manakaiReadOnly attribute contains whether the NodeList or NamedNodeMap is read-only or not.

The type of this attribute is boolean. This attribute is read-only.

1. If the NodeList or NamedNodeMap is the read-only attribute value of a Node, then the getter MUST return the manakaiReadOnly attribute value of the Node.
2. Otherwise, if the NodeList is the childNodes attribute value of a Node whose nodeType does never have any child by definition, then the getter MUST return true.
3. Otherwise, the getter MUST return true unless otherwise specified.

Extension to the Attr interface

partial interface Attr {
  readonly attribute DOMString manakaiName;
};

[86] The manakaiName attribute of the Attr interface MUST return the name of the context object.

partial interface Attr {
  attribute boolean specified;
}

Extensions to the DocumentType interface

partial interface DocumentType {
  [TreatNullAs=EmptyString] attribute DOMString publicId;
  [TreatNullAs=EmptyString] attribute DOMString systemId;
};
partial interface Entity {
  [TreatNullAs=EmptyString] attribute DOMString publicId;
  [TreatNullAs=EmptyString] attribute DOMString systemId;
};
partial interface Notation {
  [TreatNullAs=EmptyString] attribute DOMString publicId;
  [TreatNullAs=EmptyString] attribute DOMString systemId;
};

Extensions to the Entity interface

partial interface Entity {
  attribute DOMString publicId;
  attribute DOMString systemId;
  attribute DOMString? declarationBaseURI;
  attribute DOMString? manakaiDeclarationBaseURI;
  attribute DOMString? manakaiEntityBaseURI;
  attribute DOMString? manakaiEntityURI;
};

partial interface Notation {
  attribute DOMString? manakaiDeclarationBaseURI;
};

partial interface Entity {
  attribute boolean hasReplacementTree;
  attribute boolean isExternallyDeclared;
  attribute DOMString? notationName;
  attribute DOMString? xmlEncoding;
  attribute DOMString? xmlVersion;
};

Extensions to the EntityReference interface

[36] The manakaiExpanded attribute of an EntityReference object represents whether the entity reference is expanded so that its children list represents a part of the document.

This attribute is read-write. The type of the this attribute is boolean.

The getter MUST return the value of the flag associated to this attribute.

The setter MUST throw a NO_MODIFICATION_ALLOWED_ERR DOMException if the Entity object is read-only. Otherwise, it MUST set the specified value to the flag associated to this attribute.

If a parser create a EntityReference object that represents a general entity reference, it set the value of this attribute. If it set this attribute as false, then it MUST make the child list of the EntityReference object empty.

When an EntityReference object is created and then the subtree of the Entity object is cloned to that object, the manakaiExpanded MUST be set to the same value as hasReplacementTree attribute of that object.

[42] The manakaiEntityBaseURI attribute of an EntityReference object represents the base DOM URI of the entity referenced by the EntityReference object.

This attribute is read-write. The type of this attribute is DOMString.

The getter MUST return the base DOM URI of the entity by the following algorithm:

1. If the base DOM URI of the referenced entity is explicitly specified to the EntityReference object, then return it.
2. Otherwise, return the baseURI attribute value of the EntityReference object.

The setter MUST throw a NO_MODIFICATION_ALLOWED_ERR DOMException if the EntityReference object is read-only. Otherwise, if the specified value is null, it MUST unset the explicit entity base URI specification for the EntityReference object. Otherwise, it MUST set the specified value as the entity base URI of the EntityReference object.

The specified value must be an absolute DOM URI. However, no lexical validation or relative reference resolution is performed on the setting. Likewise, setting the value does not affect on the entity base URI of any Entity object and any other EntityReference object whose nodeName, publicId, or systemId is same as EntityReference object's.

[43] The manakaiExternal attribute of an EntityReference object represents whether the entity referenced by the object is an external entity or not.

This attribute is read-write. The type of this attribute is boolean.

The getter MUST return the value of the flag associated to this attribute.

The setter MUST throw a NO_MODIFICATION_ALLOWED_ERR DOMException if the object is read-only. Otherwise, it MUST set the specified value to the flag associated to this attribute.

Extensions to the Notation Interface

Extension to the ProcessingInstruction Interface

The DOMConfiguration interface

partial interface DOMConfiguration {
  readonly attribute DOMString[] parameterNames;
};

[93] The parameterNames attribute MUST return the read only array of the parameter names (DOMString[], not DOMStringList as specified in DOM3 Core), associated with the document. The attribute MUST returns the same object every time it is invoked with same context object. The items MUST be sorted by code point order.

[94] The domConfig attribute of the Document interface MUST return the same object every time it is invoked with same context object.

[101] If a parameter is an alias of another parameter, methods getParameter, setParameter, and canSetParameter MUST treat those names as equivalent.

[97] The parameter manakai-create-child-element specifies whether several Atom DOM attributes should create a child element if it is not exists. The expected value type of the parameter is boolean. The default value is false. The parameter http://suika.fam.cx/www/2006/dom-config/create-child-element is an alias of the parameter manakai-create-child-element.

[99] The parameter manakai-strict-document-children specifies whether the constraints on Document node's child nodes should not be relaxed or not. The expected value type of the parameter is boolean. The default value is true. The parameter http://suika.fam.cx/www/2006/dom-config/strict-document-children is an alias of the paramter manakai-strict-document-children.

[132] The parameter manakai-allow-doctype-children specifies whether the DocumentType node can contain ProcessingInstruction nodes as children or not. The expected value type of the parameter is boolean. The default value is false.

[174] For the purpose of conformance checkers, child nodes of Document and DocumentType MUST conform to the constraints for node trees <http://dom.spec.whatwg.org/#node-tree>, whatever values configuration parameters are set to.

[95] The parameter http://suika.fam.cx/www/2006/dom-config/clone-entity-reference-subtree specifies whether the entity reference subtree should be cloned from corresponding entity node upon creation of the node. The expected value type of the parameter is boolean. If it is the DOM3 implementation, the default value is true. Otherwise, the default value is false.

[96] The parameter http://suika.fam.cx/www/2006/dom-config/dtd-attribute-type specifies whether the DTD attribute type should be set to the schemaTypeInfo attribute of the newly created attribute node or not. The expected value type of the parameter is boolean. If it is the DOM3 implementation, the default value is true. Otherwise, the default value is false.

[98] The parameter http://suika.fam.cx/www/2006/dom-config/dtd-default-attribute specifies whether the DTD default attributes should be automatically set to elements or not. The expected value type of the parameter is boolean. If it is the DOM3 implementation, the default value is true. Otherwise, the default value is false.

[100] The parameter http://suika.fam.cx/www/2006/dom-config/xml-id specifies whether the processing of the xml:id attribute should be enabled or not. The expected value type of the parameter is boolean. If it is the DOM3 implementation, the default value is true. Otherwise, the default value is false.

[133] If the manakai-strict-document-children configuration parameter is set to true, the pre-insert operation and the replace operation on the document MUST NOT throw a "HierarchyRequestError" exception for node tree's constraints on node types in following cases:

• The type of parent is Document and the type of node is one of: Element, DocumentType, Comment, ProcessingInstruction, and Text.
• The type of parent is Document and the type of node is DocumentFragment whose children are one of: Element, DocumentType, Comment, ProcessingInstruction, and Text.

[134] If the manakai-allow-doctype-children configuration parameter of the node document is set to true, the pre-insert operation and the replace operation on the DocumentType node MUST NOT throw a "HierarchyRequestError" exception for node tree's constraints on node types in following cases:

• The type of parent is Document and the type of node is ProcessingInstruction.
• The type of parent is Document and the type of node is DocumentFragment whose children are ProcessingInstruction.

[135] If the manakai-strict-document-children configuration parameter is set to true, the textContent attribute of the Document object MUST act as if the context object were a DocumentFragment node.

Extension to the DOMLocator interface

[22] The utf32Offset attribute represents the UTF-32 offset into the input source the DOMLocator is pointing to.

The type of this attribute is long. This attribute is read-only.

The getter MUST return the UTF-32 offset specified when the DOMLocator object is created. If no such information is provided, then -1 MUST be returned.

Extensions to the TextTrack interface

[59]

partial interface TextTrack {
  readonly attribute boolean manakaiIsInvalid;
  readonly attribute TextTrackCueList manakaiAllCues;
  TextTrack manakaiCloneTrack();
};

[60] The manakaiIsInvalid attribute of the TextTrack object, on getting, MUST return true if the track has been created by a WebVTT parser and the WebVTT parser has reported that the WebVTT file from which the track object was created cannot be successfully processed as WebVTT. Otherwise, it MUST return false.

[61] The manakaiAllCues attribute of the TextTrack object, on getting, MUST return the live list that contains the cues found in the track, whether active or not, or effective or not.

[62] The manakaiCloneTrack method of the TextTrack object MUST return a new TextTrack object. The new object MUST have the same values as the original object for the attributes: kind, label, language, mode, and manakaiIsInvalid. The manakaiAllCues attribute of the new object MUST have a new TextTrackCueList object, containing the clones of the cues in the manakaiAllCues list of the original object, in order. The clones MUST be the object that would be created by the manakaiCloneCue method of the cues, with their track attributes set to the new TextTrack object.

Extensions to the TextTrackCue interface

[56]

partial interface TextTrackCue {
  readonly attribute long manakaiLine;
  readonly attribute long manakaiColumn;
  TextTrackCue manakaiCloneCue();
};

[57] The manakaiLine attribute of the TextTrackCue object, on getting, MUST return the line number in the original resource at which the cue is declared, if available, or the value -1, otherwise.

[58] The manakaiColumn attribute of the TextTrackCue object, on getting, MUST return the column number in the original resource at which the cue is declared, if available, or the value -1, otherwise.

[63] The manakaiCloneCue method of the TextTrackCue object MUST return a new TextTrackCue object. The new object MUST have the same values as the original object for the attributes: id, startTime, endTime, pauseOnExit, vertical, snapToLines, line, position, size, align, and text.

The URIReference interface

partial interface DOMImplementation {
  URIReference createURIReference((DOMString or URIReference) url);
};

[NoInterfaceObject]
interface URIReference {
  attribute DOMString uriReference;
  attribute DOMString uriScheme;
  attribute DOMString uriAuthority;
  attribute DOMString uriUserinfo;
  attribute DOMString uriHost;
  attribute DOMString uriPort;
  attribute DOMString uriPath;
  attribute DOMString uriQuery;
  attribute DOMString uriFragment;
  DOMString[] getURIPathSegment(unsigned long index);
  void setURIPathSegment(unsigned long index, DOMString newValue);
  boolean isURI();
  boolean isURI3986();
  boolean isIRI();
  boolean isIRI3987();
  boolean isRelativeReference();
  boolean isRelativeReference3986();
  boolean isRelativeIRIReference();
  boolean isRelativeIRIReference3987();
  boolean isURIReference();
  boolean isURIReference3986();
  boolean isIRIReference();
  boolean isIRIReference3987();
  boolean isAbsoluteURI();
  boolean isAbsoluteURI3986();
  boolean isAbsoluteIRI();
  boolean isAbsoluteIRI3987();
  boolean isEmptyReference();
  URIReference getURIReference();
  URIReference getURIReference3986();
  URIReference getIRIReference();
  URIReference getIRIReference3987();
  URIReference getAbsoluteReference((DOMString or URIReference) base, any opt...);
  URIReference getAbsoluteReference3986((DOMString or URIReference) base, any opt...);
  URIReference getAbsoluteReference3987((DOMString or URIReference) base, any opt...);
  boolean isSameDocumentReference((DOMString or URIReference) base);
  boolean isSameDocumentReference3986((DOMString or URIReference) base);
  boolean getRelativeReference((DOMString or URIReference) base);
  URIReference cloneURIReference();
};

The InternetMediaType interface

partial interface DOMImplementation {
  InternetMediaType createInternetMediaType(DOMString type, DOMString subtype);
};

[NoInterfaceObject]
interface InternetMediaType {
  stringifier readonly attribute DOMString imtText;
  readonly attribute DOMString type;
  attribute DOMString topLevelType;
  attribute DOMString subtype;
  readonly attribute unsigned long parameterLength;
  DOMString? getAttribute(unsigned long index);
  void setAttribute(unsigned long index, DOMString attr);
  DOMString? getValue(unsigned long index);
  void setValue(unsigned long index, DOMString value);
  DOMString? getParameter(DOMString attr);
  void setParameter(DOMString attr, DOMString value);
  void addParameter(DOMString attr, DOMString value);
  void removeParameter(DOMString attr);
};

New configuration parameters

The ParentNode interface

[177] Following members are moved to the ParentNode interface.

partial interface ParentNode {
  attribute DOMString innerHTML;
  HTMLCollection getElementsByTagName(DOMString localName);
  HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
  HTMLCollection getElementsByClassName(DOMString classNames);
  NodeList getItems(optional DOMString typeNames = "");
};

[143] The innerHTML attribute of the DocumentFragment object MUST act as if that were the body element in the HTML namespace.

[154] Methods getElementsByClassName, getElementsByTagName, and getElementsByTagNameNS of the DocumentFragment object MUST act as if those methods of the Element interface.

[176] The getItems method MUST return the node list containing elements that create top-level microdata items in the subtree rooted by the context object (inclusive). The method MUST return a static node list.

Parsing and Serialization

[147] The steps to produce an HTML serialization or produce an XML serialization MUST be defined as following:

• If the node is Element, Text, Comment, or ProcessingInstruction: Return the result of running the HTML fragment serialization algorithm or the XML fragment serialization algorithm, respectively, on a fictional node whose only child is the node.
• If the node is DocumentType: Return the result of running the HTML fragment serialization algorithm or the XML fragment serialization algorithm, respectively, on a fictional document node whose only children are the node and an element and then remove the serialization of the element from the string returned by the algorithm.

[148] If the serializeToString method is invoked with an Attr, ElementTypeDefinition, AttributeDefinition, Entity, or Notation node, then a "NotSupportedError" exception MUST be thrown.

Events

partial interface Event {
  readonly attribute boolean manakaiDispatched;
  readonly attribute boolean manakaiImmediatePropagationStopped;
  readonly attribute boolean manakaiPropagationStopped;
};

[159] The manakaiDispatched attribute of the Event interface MUST return the dispatch flag of the context object.

[160] The manakaiImmediatePropagationStopped attribute of the Event interface MUST return whether the stop immediate propagation flag of the context object is set or not.

[161] The manakaiPropagationStopped attribute of the Event interface MUST return whether the stop propagation flag of the context object is set or not.

partial interface MouseEvent {
  readonly attribute boolean altGraphKey;
};
partial interface KeyboardEvent {
  readonly attribute boolean altGraphKey;
};

[163] The altGraphKey attribute MUST return the return value of the getModifierState method on the context object with the argument AltGraph.

[165] The initKeyboardEvent] method of the KeyboardEvent interface MUST also recognize the key name AltGraph in its modifiersListArg argument.

CSSOM

partial interface StyleSheet {
  readonly attribute DOMString manakaiBaseURI;
  readonly attribute DOMString manakaiInputEncoding;
};

partial interface CSSStyleSheet {
  attribute DOMString cssText;
  DOMString? manakaiLookupNamespaceURI([TreatNullAs=EmptyString] DOMString prefix);
  DOMString? manakaiLookupNamespacePrefix([TreatNullAs=EmptyString] DOMString namespace);
  boolean manakaiIsDefaultNamespace([TreatNullAs=EmptyString] DOMString namespace);
};

[167] The manakaiBaseURI attribute of the StyleSheet interface MUST return the base URL associated with the style sheet when it is created.

[168] The manakaiInputEncoding attribute of the StyleSheet interface MUST return the encoding name Encoding Standard used to interpret the style sheet. If the style sheet is created from a character sequence (rather than byte sequence), it MUST return utf-8 instead.

[169] On getting, the cssText attribute MUST return the cssText attribute values of the rules contained in the cssRules of the CSSStyleSheet object, in same order, separated by a U+000A character.

[170] The manakaiLookupNamespaceURI method of the CSSStyleSheet interface MUST return the namespace name of the namespace prefix specified by the argument, if any, or null otherwise. If there are multiple @namespace at-rules in the style sheet, only the last one takes effect by definition. If the argument is the empty string, namespace name of the default namespace, if any, is returned instead.

[171] The manakaiLookupNamespacePrefix method of the CSSStyleSheet interface MUST return the namespace prefix bound to the namespace which is equal to the argument, if any, or null otherwise. If there are more than one namespace prefixes bound to the namespace, the namespace prefix declared later in the list of rules in the style sheet MUST be returned. Note that any @namespace at-rules with no prefix is ignored for the purpose of this method.

[172] The manakaiIsDefaultNamespace method of the CSSStyleSheet interface MUST return true if the default namespace of the style sheet css-namespaces is equal to the argument, or false otherwise.

Non-browser script support

[156] When the steps are invoked in the context where the "entry script" concept is not defined by any other specification (e.g. when a non-browser script invokes a DOM method), the base URL of the entry script MUST be about:blank unless otherwise specified by an applicable specification.

DOM3 bug fixes

[73] Methods createEntityReference and createCDATASection of the Document interface MUST throw a "NotSupportedError" exception.

partial interface Node {
  boolean isSameNode (Node? other);
};

[142] The node has a strong reference to each of user data and user data handler associated with the node using the setUserData method until they has been removed from the node by another invocation of the method with the same name argument.

[157] For the purpose of the media IDL attribute, the attribute has no default value.

Implementation-specific requirements

[155] When a method on an object may or may not return the same NodeList or HTMLCollection object as returned by the earlier calls, then the same object MUST be returned.

[91] The document has the strict error checking flag. By default, the flag is set. The strictErrorChecking of the Document interface DOM3CORE, on getting, MUST return whether the strict error checking flag of the document is set or not. On setting, the attribute MUST set the flag if the true value is assigned, or unset otherwise.

[129] Non-DOM3 implementation MUST throw exceptions or report errors as specified by relevant specifications, unless an applicable specification explicitly specifies the applicability of the strict error checking flag.

[130] If the strict error checking flag of the node document is set, for the purpose of setting name, namespace, namespace prefix, target, and/or local name of a node or attribute only, the definitions of Name, NCName, and QName MUST be replaced by the following definition: "a string of one or more Unicode code points".

[140] If the strict error checking flag of the node document is set, for the purpose of setting the name of the DocumentType node only, the definition of Name and QName MUST be replaced by the following definition: "a string of zero or more Unicode code points".

[136] If the strict error checking flag of the node document is set, when a QName is split to obtain the optional namespace prefix and the local name,

• If the first character is the COLON character, the namespace prefix]] is null and the local name is the QName.
• If the first COLON character in the QName is the last character, the namespace prefix is null and the local name is the QName.

[131] If the strict error checking flag of the node document is set, following tests, if any, MUST be skipped upon creation of elements and attributes, or setting of the namespace prefix and MUST NOT throw an exception for them:

• When the namespace prefix or the qualified name is xml or xmlns, whether the namespace URL is appropriate or not.
• When the namespace URL is the XML namespace or the XMLNS namespace, whether the namespace prefix or the qualified name is appropriate or not.
• When the namespace prefix is not null while the local name is not null, whether the namespace URL is null or not.

[139] If the strict error checking flag of the node document is set, the createProcessingInstruction method MUST skip the test whether the data contains ?> or not and MUST NOT throw an exception for it.

[137] If the strict error checking flag of the node document is set, the xmlVersion attribute of the document, on setting, MUST NOT throw an exception because of the new value's invalidness and it [MUST]] set the new value as the XML version of the document.

[138] If an operation is defined in terms of the XML version of the document or the xmlVersion attribute value but its behavior on occurrence of unknown XML version is not defined, it MUST behave as if the XML version is 1.0.

New language binding (informative)

[29] manakai is a set of Perl modules and it defines its own binding of DOM. For more information, see DOM Perl Binding [MDPB].

References

memo (informative)

[53]

       - If they are <IF::tx|DocumentType>s and at least one of them
          has the <Feature::fe|XDoctype> feature, their <A::DTDef.elementTypes>
          <IF::NamedNodeMap>s are equal, i.e. they both has the
          <Feature::fe|XDoctype> feature and their <A::DTDef.elementTypes>
          are equal (as defined for <A::Node.attributes> except
          that they cannot be <DOM::null>), or the <A::DTDef.elementTypes>
          of the node that has the <Feature::fe|XDoctype> feature
          is empty (i.e. its <A::NamedNodeMap.length> is zero).
          <SRC::manakai>

        - If they are <IF::ETDef>s, their <A::ETDef.attributeDefinitions>
          <IF::NamedNodeMap>s are equal (as defined for
          <A::Node.attributes> except that they cannot be <DOM::null>).
          <SRC::manakai>

        - If they are <IF::ATDef>s, the numeric attributes
          <A::ATDef.declaredType> and <A::ATDef.defaultType> are equal.
          <SRC::manakai>

        - If they are <IF::ATDef>s, the <A::ATDef.allowedToken>
          <IF::c|DOMStringList>s are equal, i.e. they have
          the same <A::c|DOMStringList.length> and for each string
          that exists in one list there is a string that
          exists in the other list and is equal, although
          not necessarily at the same index.  In addition,
          the number of the items that are equal to a string in one list
          is equal to the number of such items in the other list.