/* * 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.DOMException; import org.w3c.dom.stylesheets.StyleSheet; /** * The CSSStyleSheet interface is a concrete interface used to * represent a CSS style sheet i.e., a style sheet whose content type is * "text/css". *

See also the Document Object Model (DOM) Level 2 Style Specification. * @since DOM Level 2 */ public interface CSSStyleSheet extends StyleSheet { /** * If this style sheet comes from an @import rule, the * ownerRule attribute will contain the * CSSImportRule. In that case, the ownerNode * attribute in the StyleSheet interface will be * null. If the style sheet comes from an element or a * processing instruction, the ownerRule attribute will be * null and the ownerNode attribute will * contain the Node. */ public CSSRule getOwnerRule(); /** * The list of all CSS rules contained within the style sheet. This * includes both rule sets and at-rules. */ public CSSRuleList getCssRules(); /** * Used to insert a new rule into the style sheet. The new rule now * becomes part of the cascade. * @param rule The parsable text representing the rule. For rule sets * this contains both the selector and the style declaration. For * at-rules, this specifies both the at-identifier and the rule * content. * @param index The index within the style sheet's rule list of the rule * before which to insert the specified rule. If the specified index * is equal to the length of the style sheet's rule collection, the * rule will be added to the end of the style sheet. * @return The index within the style sheet's rule collection of the * newly inserted rule. * @exception DOMException * HIERARCHY_REQUEST_ERR: Raised if the rule cannot be inserted at the * specified index e.g. if an @import rule is inserted * after a standard rule set or other at-rule. *
INDEX_SIZE_ERR: Raised if the specified index is not a valid * insertion point. *
NO_MODIFICATION_ALLOWED_ERR: Raised if this style sheet is * readonly. *
SYNTAX_ERR: Raised if the specified rule has a syntax error and * is unparsable. */ public int insertRule(String rule, int index) throws DOMException; /** * Used to delete a rule from the style sheet. * @param index The index within the style sheet's rule list of the rule * to remove. * @exception DOMException * INDEX_SIZE_ERR: Raised if the specified index does not correspond to * a rule in the style sheet's rule list. *
NO_MODIFICATION_ALLOWED_ERR: Raised if this style sheet is * readonly. */ public void deleteRule(int index) throws DOMException; }