[editorial][textarea] Use consistent terminology when describing textarea element values

The textarea element definition[1] describes three value normalizations:

# The raw value is the value as it was originally set. It is not
normalized.
# The API value is the value used in the value IDL attribute. It is
normalized 
# so that line breaks use "LF" (U+000A) characters. Finally, there is the
form 
# submission value. It is normalized so that line breaks use U+000D
CARRIAGE 
# RETURN "CRLF" (U+000A) character pairs, and in addition, if necessary
given 
# the element's wrap attribute, additional line breaks are inserted to
wrap 
# the text at the given width.

These terms are useful but would be more helpful is used consistently in
subsequent paragraphs.

For instance:

# The element's value is defined to be the element's raw value with the
# following transformation applied: …

This should be 'The element's form submission value'.

Later on, the definition of the maxlength constraint states:

# If the textarea element has a maximum allowed value length, then the
# element's children must be such that the code-unit length of the value
# of the element's textContent IDL attribute is equal to or less than the
# element's maximum allowed value length.

This is accurate but may be more clearly defined as:

# If the textarea element has a maximum allowed value length, then the
element's 
# children must be such that the code-unit length of the element's API
value
# is equal to or less than the element's maximum allowed value length.

Alternatively, since textLength is explicitly defined as the code-unit
length of
the element's API value[2], we could have:

# If the textarea element has a maximum allowed value length, then the
element's
# children must be such that the value of the textLength IDL attribute is
equal to 
# or less than the element's maximum allowed value length.

There are other instances of potentially ambiguous instances of the term
'value'
in the textarea section e.g.:

# The reset algorithm for textarea aliments is to set the element's value
to the
# value of the element's textContent IDL attribute.

I think the element's value here should be the raw value.

Likewise:

# Constraint validation: If the element has its required attribute
specified, 
# and the element is mutable, and the element's value is the empty string,
# then the element is suffering from being missing.

Also, this probably intends to point to the raw value.





[1] 
http://www.w3.org/html/wg/drafts/html/master/forms.html#the-textarea-elemen

t
[2] 
http://www.w3.org/html/wg/drafts/html/master/forms.html#dom-textarea-textle

ngth

Received on Monday, 24 June 2013 21:15:56 UTC