AlierView: setStyleSheets()

AlierView に共通のスタイルシートを適用します。

このメソッドは静的メソッドです。

構文

AlierView.setStyleSheets(global, ...cssfiles) => Promise<object>

引数

• global : boolean

  true を指定すると、クラスで保持している AlierView.adoptedStyleSheets と document.adoptedStyleSheets の双方を更新して、読み込んだスタイルシートをドキュメント全体に適用します。 この操作は既存の document.adoptedStyleSheets に AlierView.adoptedStyleSheets を結合した新しい配列を作成して document.adoptedStyleSheets を置き換えます。

• cssfiles : string[]

  適用したい CSS ファイルのパスの配列。複数指定可能で、全てのファイルをマージして 1 つのスタイルシートとして適用します。

返値: Promise<object>

指定された全てのファイルをマージしたスタイルシートの持つルールリストのコピー CSSRule[] を返す Promise です。リストの各項目は単一のルール記述を表す CSSRule オブジェクトです。

例外

• TypeError
  • 引数 cssfiles で指定されたいずれかの値が文字列でなかった場合

例

// AlierView のコンテナ内にスタイルを適用
AlierView.setStyleSheets(false, "./alier_sys/ColorTheme_Nihonkai.css", "./alier_sys/AlierGlassy.css", "./my_theme.css");

// 全ドキュメントにスタイルを適用
AlierView.setStyleSheets(true, "./alier_sys/ColorTheme_Nihonkai.css", "./alier_sys/AlierGlassy.css", "./my_theme.css");

解説

AlierView に共通のスタイルシートを適用します。渡したスタイルシートは全ての AlierView 要素から参照され、即時反映されます。

このメソッドは AlierView.adoptedStyleSheets の値を更新します。

内部コンテナだけでなく、オプションでドキュメント全体に適用することもできます。