The description ot the style property does not seem correct.
From the W3C DOM 2 reference (Section 1.6.4):
"The style attribute of an HTML element is accessible through the ElementCSSInlineStyle interface which is defined in the CSS module [DOM Level 2 Style Sheets and CSS]." <URL:http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-011100101>
Following that link makes me think that the style attribute of an HTML element is part of the CSS2 extended interface:
"The CSS2Properties interface represents a convenience mechanism for retrieving and setting properties within a CSSStyleDeclaration." <URL:http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-extended>
and that it is not a 'block' but an object with proerties that can be changed. The current description is:
"Returns the block of style rules on the element."
maybe is should be:
"Returns the style object of the element."
In the notes section it states:
"though you cannot set style on an element by assigning to the style property directly"
Which is also incorrect. Style properties can be set directly, however the affect of setting them must be considered within the context of cascading styles and specificity (i.e. their affect may be over–ridden by some other style rule).
I'll leave this comment here for a while, if there is no indication to the contrary, I'll go ahead and make changes.
Yep, this page was wrong. I think I've made the necessary changes. -David Baron 22:40, 27 December 2005 (PST)
What you have done is a great improvement, but I think the summary should be:
Returns an object that contains the element style properties and values.
It actually returns an object, not a declaration (which infers a string of stuff to me). I'll have a go at it tomorrow when I've thought about it a bit more.
Incidentally, it seems that some of entries start with a 'Summary' heading, and others with the name of the property/method/whatever. Which is preferred? I tend to go for the name as summary is pretty meaningless.
--RobG 07:43, 31 December 2005 (PST)
The common part of DOM:cssRule.style and this page should be factored out into a separate page, documenting CSSStyleDeclaration. --Nickolay 02:38, 26 June 2006 (PDT) (It turns out that DOM:CSS is the page I was thinking of. ) --Nickolay 02:46, 26 June 2006 (PDT)
I think the following sentence in the Summary is incorrect or misleading. I don't think you can set a style property with set attribute at all.
It is generally better to use the style property than elt.setAttribute('style', '...') from a script, since use of the style property will not overwrite other CSS properties that may be specified in the style attribute.ele.setAttribute("style", "color: blue;") does not work, nor does ele.style = "color: blue;" which one would assume should work as the parallel to the specification
<span id="foo" style="color: blue;">Which IE users can use.
Therefore I've replaced the sentence indicating what can be done.
--User:Riboribo 24 Apr 2007