/*
 * 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.stylesheets;

import org.w3c.dom.Node;

The StyleSheet interface is the abstract base interface for any type of style sheet. It represents a single style sheet associated with a structured document. In HTML, the StyleSheet interface represents either an external style sheet, included via the HTML LINK element, or an inline STYLE element. In XML, this interface represents an external style sheet, included via a style sheet processing instruction.

See also the Document Object Model (DOM) Level 2 Style Specification.

Since:1.4, DOM Level 2
/** * The <code>StyleSheet</code> interface is the abstract base interface for * any type of style sheet. It represents a single style sheet associated * with a structured document. In HTML, the StyleSheet interface represents * either an external style sheet, included via the HTML LINK element, or * an inline STYLE element. In XML, this interface represents an external * style sheet, included via a style sheet processing instruction. * <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 StyleSheet {
This specifies the style sheet language for this style sheet. The style sheet language is specified as a content type (e.g. "text/css"). The content type is often specified in the ownerNode. Also see the type attribute definition for the LINK element in HTML 4.0, and the type pseudo-attribute for the XML style sheet processing instruction.
/** * This specifies the style sheet language for this style sheet. The * style sheet language is specified as a content type (e.g. * "text/css"). The content type is often specified in the * <code>ownerNode</code>. Also see the type attribute definition for * the <code>LINK</code> element in HTML 4.0, and the type * pseudo-attribute for the XML style sheet processing instruction. */
public String getType();
false if the style sheet is applied to the document. true if it is not. Modifying this attribute may cause a new resolution of style for the document. A stylesheet only applies if both an appropriate medium definition is present and the disabled attribute is false. So, if the media doesn't apply to the current user agent, the disabled attribute is ignored.
/** * <code>false</code> if the style sheet is applied to the document. * <code>true</code> if it is not. Modifying this attribute may cause a * new resolution of style for the document. A stylesheet only applies * if both an appropriate medium definition is present and the disabled * attribute is false. So, if the media doesn't apply to the current * user agent, the <code>disabled</code> attribute is ignored. */
public boolean getDisabled();
false if the style sheet is applied to the document. true if it is not. Modifying this attribute may cause a new resolution of style for the document. A stylesheet only applies if both an appropriate medium definition is present and the disabled attribute is false. So, if the media doesn't apply to the current user agent, the disabled attribute is ignored.
/** * <code>false</code> if the style sheet is applied to the document. * <code>true</code> if it is not. Modifying this attribute may cause a * new resolution of style for the document. A stylesheet only applies * if both an appropriate medium definition is present and the disabled * attribute is false. So, if the media doesn't apply to the current * user agent, the <code>disabled</code> attribute is ignored. */
public void setDisabled(boolean disabled);
The node that associates this style sheet with the document. For HTML, this may be the corresponding LINK or STYLE element. For XML, it may be the linking processing instruction. For style sheets that are included by other style sheets, the value of this attribute is null.
/** * The node that associates this style sheet with the document. For HTML, * this may be the corresponding <code>LINK</code> or <code>STYLE</code> * element. For XML, it may be the linking processing instruction. For * style sheets that are included by other style sheets, the value of * this attribute is <code>null</code>. */
public Node getOwnerNode();
For style sheet languages that support the concept of style sheet inclusion, this attribute represents the including style sheet, if one exists. If the style sheet is a top-level style sheet, or the style sheet language does not support inclusion, the value of this attribute is null.
/** * For style sheet languages that support the concept of style sheet * inclusion, this attribute represents the including style sheet, if * one exists. If the style sheet is a top-level style sheet, or the * style sheet language does not support inclusion, the value of this * attribute is <code>null</code>. */
public StyleSheet getParentStyleSheet();
If the style sheet is a linked style sheet, the value of its attribute is its location. For inline style sheets, the value of this attribute is null. See the href attribute definition for the LINK element in HTML 4.0, and the href pseudo-attribute for the XML style sheet processing instruction.
/** * If the style sheet is a linked style sheet, the value of its attribute * is its location. For inline style sheets, the value of this attribute * is <code>null</code>. See the href attribute definition for the * <code>LINK</code> element in HTML 4.0, and the href pseudo-attribute * for the XML style sheet processing instruction. */
public String getHref();
The advisory title. The title is often specified in the ownerNode. See the title attribute definition for the LINK element in HTML 4.0, and the title pseudo-attribute for the XML style sheet processing instruction.
/** * The advisory title. The title is often specified in the * <code>ownerNode</code>. See the title attribute definition for the * <code>LINK</code> element in HTML 4.0, and the title pseudo-attribute * for the XML style sheet processing instruction. */
public String getTitle();
The intended destination media for style information. The media is often specified in the ownerNode. If no media has been specified, the MediaList will be empty. See the media attribute definition for the LINK element in HTML 4.0, and the media pseudo-attribute for the XML style sheet processing instruction . Modifying the media list may cause a change to the attribute disabled.
/** * The intended destination media for style information. The media is * often specified in the <code>ownerNode</code>. If no media has been * specified, the <code>MediaList</code> will be empty. See the media * attribute definition for the <code>LINK</code> element in HTML 4.0, * and the media pseudo-attribute for the XML style sheet processing * instruction . Modifying the media list may cause a change to the * attribute <code>disabled</code>. */
public MediaList getMedia(); }