org.w3c.dom.css.CSSStyleSheet Maven / Gradle / Ivy

/*
 * Copyright (C) 2005 by Quentin Anciaux
 *
 * This library is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Library General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or (at your
 * option) any later version.
 *
 * This library 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 Library General Public License
 * for more details.
 *
 * You should have received a copy of the GNU Library General Public License
 * along with this library; if not, write to the Free Software Foundation,
 * Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 *
 *	@author Quentin Anciaux
 */

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.
     *
     * @return DOCUMENT ME!
     */
    public CSSRule getOwnerRule();

    /**
     * The list of all CSS rules contained within the style sheet. This
     * includes both rule sets and at-rules.
     *
     * @return DOCUMENT ME!
     */
    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;
}