001/* 002 * Copyright (c) 2000 World Wide Web Consortium, 003 * (Massachusetts Institute of Technology, Institut National de 004 * Recherche en Informatique et en Automatique, Keio University). All 005 * Rights Reserved. This program is distributed under the W3C's Software 006 * Intellectual Property License. This program is distributed in the 007 * hope that it will be useful, but WITHOUT ANY WARRANTY; without even 008 * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 009 * PURPOSE. 010 * See W3C License http://www.w3.org/Consortium/Legal/ for more details. 011 */ 012 013package org.w3c.dom.css; 014 015import org.w3c.dom.Element; 016import org.w3c.dom.stylesheets.DocumentStyle; 017 018/** 019 * This interface represents a document with a CSS view. 020 * <p> The <code>getOverrideStyle</code> method provides a mechanism through 021 * which a DOM author could effect immediate change to the style of an 022 * element without modifying the explicitly linked style sheets of a 023 * document or the inline style of elements in the style sheets. This style 024 * sheet comes after the author style sheet in the cascade algorithm and is 025 * called override style sheet. The override style sheet takes precedence 026 * over author style sheets. An "!important" declaration still takes 027 * precedence over a normal declaration. Override, author, and user style 028 * sheets all may contain "!important" declarations. User "!important" rules 029 * take precedence over both override and author "!important" rules, and 030 * override "!important" rules take precedence over author "!important" 031 * rules. 032 * <p> The expectation is that an instance of the <code>DocumentCSS</code> 033 * interface can be obtained by using binding-specific casting methods on an 034 * instance of the <code>Document</code> interface. 035 * <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>. 036 * @since DOM Level 2 037 */ 038public interface DocumentCSS extends DocumentStyle { 039 /** 040 * This method is used to retrieve the override style declaration for a 041 * specified element and a specified pseudo-element. 042 * @param elt The element whose style is to be modified. This parameter 043 * cannot be null. 044 * @param pseudoElt The pseudo-element or <code>null</code> if none. 045 * @return The override style declaration. 046 */ 047 public CSSStyleDeclaration getOverrideStyle(Element elt, 048 String pseudoElt); 049 050}