/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/*
* This file is available under and governed by the GNU General Public
* License version 2 only, as published by the Free Software Foundation.
* However, the following notice accompanied the original version of this
* file and, per its terms, should not be removed:
*
* Copyright (c) 2000 World Wide Web Consortium,
* (Massachusetts Institute of Technology, Institut National de
* Recherche en Informatique et en Automatique, Keio University). All
* Rights Reserved. This program is distributed under the W3C's Software
* Intellectual Property License. This program is distributed in the
* hope that it will be useful, but WITHOUT ANY WARRANTY; without even
* the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
* PURPOSE.
* See W3C License http://www.w3.org/Consortium/Legal/ for more details.
*/
package org.w3c.dom.css;
import org.w3c.dom.Element;
import org.w3c.dom.stylesheets.DocumentStyle;
This interface represents a document with a CSS view.
The getOverrideStyle
method provides a mechanism through
which a DOM author could effect immediate change to the style of an
element without modifying the explicitly linked style sheets of a
document or the inline style of elements in the style sheets. This style
sheet comes after the author style sheet in the cascade algorithm and is
called override style sheet. The override style sheet takes precedence
over author style sheets. An "!important" declaration still takes
precedence over a normal declaration. Override, author, and user style
sheets all may contain "!important" declarations. User "!important" rules
take precedence over both override and author "!important" rules, and
override "!important" rules take precedence over author "!important"
rules.
The expectation is that an instance of the DocumentCSS
interface can be obtained by using binding-specific casting methods on an
instance of the Document
interface.
See also the Document Object Model (DOM) Level 2 Style Specification.
Since: 1.4, DOM Level 2
/**
* This interface represents a document with a CSS view.
* <p> The <code>getOverrideStyle</code> method provides a mechanism through
* which a DOM author could effect immediate change to the style of an
* element without modifying the explicitly linked style sheets of a
* document or the inline style of elements in the style sheets. This style
* sheet comes after the author style sheet in the cascade algorithm and is
* called override style sheet. The override style sheet takes precedence
* over author style sheets. An "!important" declaration still takes
* precedence over a normal declaration. Override, author, and user style
* sheets all may contain "!important" declarations. User "!important" rules
* take precedence over both override and author "!important" rules, and
* override "!important" rules take precedence over author "!important"
* rules.
* <p> The expectation is that an instance of the <code>DocumentCSS</code>
* interface can be obtained by using binding-specific casting methods on an
* instance of the <code>Document</code> interface.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>.
* @since 1.4, DOM Level 2
*/
public interface DocumentCSS extends DocumentStyle {
This method is used to retrieve the override style declaration for a
specified element and a specified pseudo-element.
Params: - elt – The element whose style is to be modified. This parameter
cannot be null.
- pseudoElt – The pseudo-element or
null
if none.
Returns: The override style declaration.
/**
* This method is used to retrieve the override style declaration for a
* specified element and a specified pseudo-element.
* @param elt The element whose style is to be modified. This parameter
* cannot be null.
* @param pseudoElt The pseudo-element or <code>null</code> if none.
* @return The override style declaration.
*/
public CSSStyleDeclaration getOverrideStyle(Element elt,
String pseudoElt);
}