May 1, 2000
Please email error reports to www-dom@w3.org.
Also, the first item of the list about "DOM Interfaces and DOM Implementations" has text about "read-only functions" which is meant to be "read-only attributes".
DOMString
type is defined as "a sequence of 16-bit
quantities". Instead, it should be defined as "sequence of 16-bit
units".
Then, the description contains the following sentences:
Please note that for both HTML and XML, the document character set
(and therefore the notation of numeric character references) is based
on UCS-4. A single numeric character reference in a source document
may therefore in some cases correspond to two array positions in a
DOMString
(a high surrogate and a low
surrogate).
It should read:
Please note that for both HTML and XML, the document character set
(and therefore the notation of numeric character references) is based
on UCS [ISO-10646]. A single numeric character reference in a source
document may therefore in some cases correspond to two 16-bit units in
a DOMString
(a high surrogate and a low
surrogate).
For the purposes of the DOM, string matching takes place on a character code by character code basis, on the 16 bit value of a DOMString. As such, the DOM assumes that any normalizations will take place in the processor, before the DOM structures are built.
This sentence should read:
For the purposes of the DOM, string matching is performed purely by binary comparison of the 16-bit units of the DOMString. As such, the DOM assumes that any normalizations take place in the processor, before the DOM structures are built.
value
attribute raises a
NO_MODIFICATION_ALLOWED_ERR
DOMException when the node is
readonly.length
attribute reads:
The number of characters that are available through data and the
substringData
method below.
It should read:
The number of 16-bit units that are available through data and the
substringData
method below.
The description of the count
parameter of the
substringData
method reads:
The number of characters to extract.
It should read:
The number of 16-bit units to extract.
Then the description of the return value reads:
The specified substring. If the sum ofoffset
andcount
exceeds thelength
, then all characters to the end of the data are returned.
It should read:
The specified substring. If the sum ofoffset
andcount
exceeds thelength
, then all 16-bit units to the end of the data are returned.
The exception INDEX_SIZE_ERR is said to be:
Raised if the specifiedoffset
is negative or greater than the number of characters in data, or if the specifiedcount
is negative.
Instead this should read:
Raised if the specifiedoffset
is negative or greater than the number of 16-bit units in data, or if the specifiedcount
is negative.
The description of the insertData
method reads:
Insert a string at the specified character offset.
Instead it should read:
Insert a string at the specified 16-bit unit offset.
Then the description of the offset
parameter reads:
The character offset at which to insert.
when it should read:
The 16-bit unit offset at which to insert.
The exception INDEX_SIZE_ERR is said to be:
Raised if the specifiedoffset
is negative or greater than the number of characters in data, or if the specifiedcount
is negative.
Instead this should read:
Raised if the specifiedoffset
is negative or greater than the number of 16-bit units in data, or if the specifiedcount
is negative.
The description of the deleteData
method reads:
Remove a range of characters from the node.
Instead it should read:
Remove a range of 16-bit units from the node.
Then the description of the count
parameter reads:
The number of characters to delete. If the sum ofoffset
andcount
exceedslength
then all characters fromoffset
to the end of the data are deleted.
when it should read:
The number of 16-bit units to delete. If the sum ofoffset
andcount
exceedslength
then all 16-bit units fromoffset
to the end of the data are deleted.
The description of the replaceData
method reads:
Replace the characters starting at the specified character offset with the specified string.
instead it should read:
Replace the characters starting at the specified 16-bit unit offset with the specified string.
Then the description of the count
parameter reads:
The number of characters to replace. If the sum ofoffset
andcount
exceedslength
, then all characters to the end of the data are replaced
when it should read:
The number of 16-bit units to replace. If the sum ofoffset
andcount
exceedslength
, then all 16-bit units to the end of the data are replaced
The exception INDEX_SIZE_ERR is said to be:
Raised if the specifiedoffset
is negative or greater than the number of characters in data, or if the specifiedcount
is negative.
Instead this should read:
Raised if the specifiedoffset
is negative or greater than the number of 16-bit units in data, or if the specifiedcount
is negative.
version
parameter reads:
in Level 1, this is the string "1.0"
This should read:
In Level 1, version 1.0, this is the string "1.0"
createElement
method is missing
the following piece:
In addition, if there are known attributes with default values, Attr nodes representing them are automatically created and attached to the element.
The description of the createEntityReference
method is
missing the following piece:
In addition, if the referenced entity is known, the child list of the
EntityReference
node is made the same as that of the correspondingEntity
node.
the generic Node interface method getAttributes
may be
used to retrieve the set of all attributes for an
element.
However, there is no getAttributes method per se, although it may exist in some language binding such as the java one. So this section should read:
the generic Node interface attribute attributes
may be
used to retrieve the set of all attributes for an
element.
The removeAttribute
method description reads:
If the removed attribute has a default value it is immediately replaced.
This should read:
If the removed attribute is known to have a default value, an attribute immediately appears containing the default value.
removeNamedItem
method reads:
The node removed from the map or null if no node with such a name exists.
But this error case is already handled by having the method to throw a NOT_FOUND_ERR DOMException. So this section should simply read:
The node removed from the map if a node with such a name exists.
The description of the removeNamedItem
method should
include the following note:
When this NamedNodeMap contains the attributes attached to an element,
as returned by the attributes
attribute of the Node
interface, if the removed attribute is known to have a default value,
an attribute immediately appears containing the default
value.
In addition, the removeNamedItem
method should raise a NO_MODIFICATION_ALLOWED_ERR
DOMException
when the NamedNodeMap
is
readonly.
offset
parameter of the
splitText
method reads:
The offset
at which to split, starting from
0.
when it should read:
The 16-bit unit offset
at which to split, starting from
0.
The exception INDEX_SIZE_ERR is said to be:
Raised if the specified offset
is negative or greater
than the number of characters in data.
Instead this should read:
Raised if the specified offset
is negative or greater
than the number of 16-bit units in data.
defaultValue
attribute should
read:
When the type
attribute of the element has the value
"Text", "File" or "Password", this represents the HTML value attribute
of the element. The value of this attribute does not change if the
contents of the corresponding form control in an interactive user
agent changes. Changing this attribute, however, resets the contents
of the form control. See the value
attribute definition in HTML 4.0.
value
attribute should read:
When thetype
attribute of the element has the value "Text", "File" or "Password", this represents the current contents of the corresponding form control in an interactive user agent. Changing this attribute changes the contents of the form control, but does not change the value of the HTML value attribute of the element. When thetype
attribute of the element has the value "Button", "Hidden", "Submit", "Reset", "Image", "Checkbox" or "Radio", this represents the HTML value attribute of the element. See the value attribute definition in HTML 4.0.
defaultChecked
attribute should
read:
When the type
attribute of the element has the value
"Checkbox" or "Radio", this represents the HTML checked attribute of
the element. The value of this attribute does not change if the state
of the corresponding form control in an interactive user agent
changes. Changes to this attribute, however, resets the state of the
form control. See the checked
attribute definition in HTML 4.0.
checked
attribute should read:
When the type
attribute of the element has the value
"Checkbox" or "Radio", this represents the current state of the
corresponding form control in am interactive user agent. Changes to
this attribute changes the state of the form control, but does not
change the value of the HTML value attribute of the
element.
defaultSelected
attribute should
read:
Represents the value of the HTML selected attribute. The value of this
attribute does not change if the state of the corresponding form
control in an interactive user agent changes. Changing
defaultSelected
, however, resets the state of the form
control. See the selected
attribute definition in HTML 4.0.
selected
attribute should read:
Represents the current state of the corresponding form control in an interactive user agent. Changing this attribute changes the state of the form control, but does not change the value of the HTML selected attribute of the element.
index
attribute actually is readonly. On the other
hand, the selected
attribute is not.type
attribute is the string
"select-multiple" when the multiple
attribute is
true
and the string "select-one" when
false
.before
parameter of the
add
method reads:
The element to insert before, or null
for the head of the
list.
Instead it should read:
The element to insert before, or null
for the tail of the
list.
index
parameter of the
insertRow
and deleteRow
methods is missing the
following:
This index starts from 0 and is relative to all the rows contained inside the table, regardless of section parentage.
In addition, the description of the insertRow
method is
missing the following:
The new row is inserted immediately before and in the same section as the currentindex
th row in the table. Ifindex
is equal to the number of rows, the new row is appended.
In addition, when the table is empty the row is inserted into aTBODY
which is created and inserted into the table.
index
parameter of the
insertRow
and deleteRow
methods is missing the
following:
This index starts from 0 and is relative only to the rows contained inside this section, not all the rows in the table.
cellIndex
attribute actually is readonly.rowIndex
, selectionRowIndex
, and
cells
attributes actually are readonly.type
attribute is the string
"textarea".defaultValue
attribute should
read:
Represents the contents of the element. The value of this attribute does not change if the contents of the corresponding form control in an interactive user agent changes. Changing this attribute, however, resets the contents of the form control.
value
attribute should read:
Represents the current contents of the corresponding form control in an interactive user agent. Changing this attribute changes the contents of the form control, but does not change the contents of the element.
Even though the DOM defines the name of the string type to be DOMString, bindings may used different names.
It should read "use" instead of "used".