この標準情報(TR)は,2000年11月にWorld Wide Web Consortium(W3C)から公表された Document Object Model (DOM) Level 2 Style Specification, version 1.0 勧告を翻訳し,技術的内容を変更することなく作成した標準情報(TR)である。
この標準情報(TR)は,プログラム及びスクリプトがスタイルシート文書の内容に動的にアクセスし更新することを可能にする,プラットフォーム中立で言語中立なインタフェースである文書オブジェクトモデル水準2のスタイルシート及び段階スタイルシート(CSS)を規定する。文書オブジェクトモデル水準2 スタイルは,文書オブジェクトモデル水準2 コア[DOM Level 2 Core]及び文書オブジェクトモデル水準2 ビュー[DOM Level 2 Views]の上に構築される。
DOM水準2スタイルシートのインタフェースは,あらゆる種類のスタイルシートをも表現するのに用いられる基底インタフェースとする。特定のスタイルシート言語を表現するDOMモジュールは,これらのインタフェースから派生するインタフェースを含んでよいことが期待される。
1.の中で示すインタフェースは,必須ではない。DOMアプリケーションは,このモジュールが実装によってサポートされるかどうかを決定するために,DOMImplementation
インタフェースのhasFeature(feature, version)
メソッドを,そのパラメタ値をそれぞれ"StyleSheets"及び"2.0"として使用してもよい。
このモジュールを十分にサポートするためには,実装は,DOM水準2 コア規定[DOM Level 2 Core]の中で定義される"コア"機能もサポートしなければならない。DOM水準2 コア規定[DOM Level 2 Core]における適合性に関する追加情報を参照すること。
次のインタフェースの集合は,スタイルシートの共通記法を表現する。
StyleSheet
インタフェースは,あらゆる種類のスタイルシートのための抽象基底インタフェースとする。それは,構造化文書に関連する一つのスタイルシートを表現する。
HTMLにおいては,StyleSheetインタフェースは,HTMLのLINK要素によって取り込まれる外部スタイルシート,又は行内のSTYLE要素のどちらかを表現する。
XMLにおいては,このインタフェースは,スタイル処理命令によって取り込まれる外部スタイルシートを表現する。
// Introduced in DOM Level 2: interface StyleSheet { readonly attribute DOMString type; attribute boolean disabled; readonly attribute Node ownerNode; readonly attribute StyleSheet parentStyleSheet; readonly attribute DOMString href; readonly attribute DOMString title; readonly attribute MediaList media; };
boolean
のdisabled
false
となり, そうでない場合,true
となる。この属性を変更することで,文書のスタイルを新しくできる。適切なメディア定義があって,しかもdisabled
属性がfalse
の場合だけに,スタイルシートが適用される。そこで,メディアが現在の利用者エージェントに適用できない場合には,disabled
属性は無視される。
DOMString
のhref
,読取り専用
null
とする。HTML 4.0のLINK
要素のためにはhref属性定義,及びXMLのスタイルシート処理命令のためにはhref擬似属性を参照すること。
MediaList
のmedia
,読取り専用
ownerNode
の中で指定されることが多い。
メディアが指定されない場合には,MediaList
は空になる。HTML 4.0のLINK
要素のためにはメディア属性定義,及びXMLのスタイルシート処理命令のためにはメディア擬似属性を参照すること。メディアリストを修正することによって,disabled
属性への変更を生じてもよい。
Node
のownerNode
,読取り専用
LINK
要素又はSTYLE
要素であってよい。XMLに対しては,これは,リンク付け処理命令であってよい。他のスタイルシートによって取り込まれるスタイルシートに対しては,この属性の値は,null
とする。
StyleSheet
のparentStyleSheet
,読取り専用
null
とする。
DOMString
のtitle
,読取り専用
ownerNode
の中で指定されることが多い。HTML 4.0のLINK
要素のためには標題属性定義,及びXMLのためにはスタイルシート処理命令に関する標題擬似属性を参照すること。
DOMString
のtype
,読取り専用
ownerNode
の中で指定されることが多い。
HTML 4.0のLINK
要素のためには型属性定義,及びXMLのためにはスタイルシート処理命令に関する型擬似属性も参照すること。
StyleSheetList
インタフェースは,スタイルシートの順序付き集合の抽象化を与える。
StyleSheetList
における項目は,0から始まる整数インデクスによってアクセスできる。
// Introduced in DOM Level 2: interface StyleSheetList { readonly attribute unsigned long length; StyleSheet item(in unsigned long index); };
unsigned long
のlength
,読取り専用
StyleSheets
の数。妥当な子スタイルシートインデクスの範囲は,0
からlength-1
までとする。
item
null
を返す。
unsigned long
のindex
|
MediaList
インタフェースは,この集まりの実装方法を定義又は制約することなしに,メディアの順序付き集まりの抽象化を与える。空リストは,メディア"all"
を含むリストと同じとする。
MediaList
における項目は,0から始まる整数インデクスによってアクセスできる。
// Introduced in DOM Level 2: interface MediaList { attribute DOMString mediaText; // raises(DOMException) on setting readonly attribute unsigned long length; DOMString item(in unsigned long index); void deleteMedium(in DOMString oldMedium) raises(DOMException); void appendMedium(in DOMString newMedium) raises(DOMException); };
appendMedium
newMedium
を追加する。newMedium
が既に使用されている場合には,それが,最初に取り除かれる。
DOMString
のnewMedium
|
INVALID_CHARACTER_ERR: メディアが,基礎となるスタイル言語の中で有効でない文字を含む場合に,挙げられる。 NO_MODIFICATION_ALLOWED_ERR: このリストが読取り専用の場合に,挙げられる。 |
deleteMedium
oldMedium
によって指示されるメディアを,リストから削除する。
DOMString
のoldMedium
|
NO_MODIFICATION_ALLOWED_ERR: このリストが読取り専用の場合に,挙げられる。 NOT_FOUND_ERR:
|
item
インデクス
番目を返す。インデクス
がリストの中のメディアの数以上の場合,これは,null
を返す。
unsigned long
のindex
|
|
LinkStyle
インタフェースは,スタイルシートを文書にリンク付けする働きをもつノードからそのスタイルシートを取得できる機構を与える。LinkStyle
インタフェースのインスタンスは,リンク付けノードのインスタンスにおける束縛固有のキャストメソッド(DOM水準2のHTMLLinkElement
,HTMLStyleElement
又はProcessingInstruction
)を用いて,得ることができる。
// Introduced in DOM Level 2: interface LinkStyle { readonly attribute StyleSheet sheet; };
StyleSheet
のsheet
,読取り専用
DocumentStyle
インタフェースは,文書に組み込まれたスタイルシートを取得できる機構を与える。DocumentStyle
インタフェースのインスタンスは,Document
インタフェースのインスタンスにおける束縛固有のキャストメソッドを用いて,得ることができると期待される。
// Introduced in DOM Level 2: interface DocumentStyle { readonly attribute StyleSheetList styleSheets; };
StyleSheetList
のstyleSheets
,読取り専用
HTMLLinkElement
インタフェース参照)。要素が文書中に挿入され,リンク付けされたオブジェクトがスタイルシートであることを示す方法で,href属性及びtype属性の両方が設定された後に,基礎となるスタイルシートが生成される。
HTMLStyleElement
参照)。要素が文書中に挿入され,利用者エージェントによって解釈されるスタイルシート言語にその要素が対応することを示す方法で,type属性が設定された後に,基礎となるスタイルシートが生成される。