Common DOM API

org.w3c.dom.css
インタフェース CSSStyleDeclaration


public interface CSSStyleDeclaration

CSSStyleDeclaration インタフェースは、単一の CSS 宣言ブロックを 表します。このインタフェースは、ブロック内で現在設定されているスタイルプロパティを 判別したり、ブロック内にスタイルプロパティを明示的に指定したりするために使用でき ます。

実装によっては CSS 宣言ブロック内の一部の CSS プロパティを認識できない場合が あるため、スタイルシート内に指定されているすべてのプロパティに CSSStyleDeclaration インタフェースによってアクセスできるようにする ことが期待されています。さらに、特定のレベルの CSS をサポートしている実装は、 そのレベルの CSS の短縮形プロパティを正しく処理できる必要があります。短縮形の プロパティについて詳しくは、CSS2Properties インタフェースを参照して ください。

このインタフェースは、要素の計算された値への読み取り専用アクセスを提供する ためにも使用されます。ViewCSS インタフェースも参照してください。 CSS のオブジェクトモデルでは、CSS カスケードの指定した値、または実際の値に アクセスする手段は提供されていません。

「Document Object Model (DOM) Level 2 Style Specification」も参照してください。

導入されたバージョン:
DOM Level 2

メソッドの概要
 String getCssText()
          宣言ブロックの、解析可能なテキスト表現 (宣言を囲んでいる中括弧は除く) です。
 int getLength()
          この宣言ブロック内で明示的に設定されているプロパティの数です。
 CSSRule getParentRule()
          この宣言ブロックを含んでいる CSS ルールです。
 CSSValue getPropertyCSSValue(String propertyName)
          この宣言ブロック内で明示的に設定されている CSS プロパティの値のオブジェクト表現を 取得するために使用します。
 String getPropertyPriority(String propertyName)
          この宣言ブロック内で明示的に設定されている CSS プロパティの優先順位 (たとえば、 "important" 識別子) を取得するために使用します。
 String getPropertyValue(String propertyName)
          この宣言ブロック内で明示的に設定されている CSS プロパティの値を取得するために 使用します。
 String item(int index)
          この宣言ブロック内で明示的に設定されているプロパティを取得するために使用します。
 String removeProperty(String propertyName)
          この宣言ブロック内で明示的に設定されている CSS プロパティを削除するために 使用します。
 void setCssText(String cssText)
           
 void setProperty(String propertyName, String value, String priority)
          この宣言ブロック内にプロパティ値と優先順位を設定するために使用します。
 

メソッドの詳細

getCssText

public String getCssText()
宣言ブロックの、解析可能なテキスト表現 (宣言を囲んでいる中括弧は除く) です。 この属性に値を設定すると、新しい値が解析されて、宣言ブロック内のすべての プロパティがリセットされます。これには、プロパティの削除や追加も含まれます。

例外:
DOMException - SYNTAX_ERR:指定された CSS 文字列値に構文エラーがあり、解析できない場合に 発生する
NO_MODIFICATION_ALLOWED_ERR:この宣言が読み取り専用か、プロパティが 読み取り専用である場合に発生する

setCssText

public void setCssText(String cssText)
                throws DOMException
DOMException

getPropertyValue

public String getPropertyValue(String propertyName)
この宣言ブロック内で明示的に設定されている CSS プロパティの値を取得するために 使用します。

パラメータ:
propertyName - CSS プロパティの名前。CSS プロパティのインデックスを参照
戻り値:
プロパティがこの宣言ブロック内で明示的に設定されている場合は、その プロパティの値を返す。そのプロパティが設定されていない場合は、空の文字列を返す

getPropertyCSSValue

public CSSValue getPropertyCSSValue(String propertyName)
この宣言ブロック内で明示的に設定されている CSS プロパティの値のオブジェクト表現を 取得するために使用します。指定されたプロパティが短縮形の場合、このメソッドは null を返します。短縮形のプロパティの値は、getPropertyValue および setProperty メソッドを使用して、文字列としてのみ取得したり 修正したりできます。

パラメータ:
propertyName - CSS プロパティの名前。CSS プロパティのインデックスを参照
戻り値:
プロパティがこの宣言ブロック内で明示的に設定されている場合は、その プロパティの値を返す。そのプロパティが設定されていない場合は、null を返す

removeProperty

public String removeProperty(String propertyName)
                      throws DOMException
この宣言ブロック内で明示的に設定されている CSS プロパティを削除するために 使用します。

パラメータ:
propertyName - CSS プロパティの名前。CSS プロパティのインデックスを 参照
戻り値:
プロパティがこの宣言ブロック内で明示的に設定されている場合は、その プロパティの値を返す。そのプロパティが設定されていない場合、またはプロパティ名が 既知の CSS プロパティに対応していない場合には、空の文字列を返す
例外:
DOMException - NO_MODIFICATION_ALLOWED_ERR:この宣言が読み取り専用であるか、プロパティが 読み取り専用である場合に発生する

getPropertyPriority

public String getPropertyPriority(String propertyName)
この宣言ブロック内で明示的に設定されている CSS プロパティの優先順位 (たとえば、 "important" 識別子) を取得するために使用します。

パラメータ:
propertyName - CSS プロパティの名前。CSS プロパティのインデックスを参照
戻り値:
存在する場合、優先順位を表す文字列 (たとえば、"important")。 存在しなければ、空の文字列

setProperty

public void setProperty(String propertyName,
                        String value,
                        String priority)
                 throws DOMException
この宣言ブロック内にプロパティ値と優先順位を設定するために使用します。

パラメータ:
propertyName - CSS プロパティの名前。CSS プロパティのインデックスを 参照
value - そのプロパティの新しい値
priority - そのプロパティの新しい優先順位 (たとえば、"important")
例外:
DOMException - SYNTAX_ERR:指定された値に構文エラーがあり、解析できない場合に発生する
NO_MODIFICATION_ALLOWED_ERR:この宣言が読み取り専用であるか、プロパティが 読み取り専用である場合に発生する

getLength

public int getLength()
この宣言ブロック内で明示的に設定されているプロパティの数です。有効な インデックスの範囲は、0 から length-1 までです。


item

public String item(int index)
この宣言ブロック内で明示的に設定されているプロパティを取得するために使用します。 このメソッドを使用して取得するプロパティの順序は、設定された順序と同じである 必要はありません。このメソッドは、宣言ブロック内のすべてのプロパティを反復して 処理するために利用できます。

パラメータ:
index - 取得するプロパティ名のインデックス
戻り値:
この順序位置にあるプロパティの名前。この位置にプロパティが存在しない 場合は、空の文字列

getParentRule

public CSSRule getParentRule()
この宣言ブロックを含んでいる CSS ルールです。または、この CSSStyleDeclarationCSSRule に結び付けられて いない場合は null です。


Common DOM API

バグや機能要求の報告
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.