CSSStyleDeclaration.cssText - テキスト

2017/10/14

cssTextは、CSSStyleDeclarationのプロパティです。全種類のスタイルシートをテキストで返します。

概要

名前

cssText

所属

IDL

[CEReactions] attribute CSSOMString cssText;

typedef USVString CSSOMString;

仕様書

https://drafts.csswg.org/cssom/#dom-cssstyledeclaration-csstext

説明

全種類のスタイルシートを、テキストで返す。

値を代入して変更することもできる。ただし、計算値のCSSStyleDeclarationの場合は変更できない。

チュートリアル

style属性のスタイルシートのテキストを取得する例です。

<p style="color:red;font-weight:700;" id="hoge">SYNCER</p>

var element = document.getElementById( "hoge" ) ;
var cssStyleDeclaration = element.style ;
var value = cssStyleDeclaration.cssText ;	// "color:red;font-weight:700;"

値を代入すれば、スタイルシートをまとめて変更できます。ただし、Window.getComputedStyle()で取得した計算値のスタイルシートは変更することができないのでご注意下さい。

cssStyleDeclaration.cssText = "color:blue;font-weight:400;" ;

デモ

CSSStyleDeclaration.cssTextのデモです。style属性のスタイルシートを取得する場合と、計算値のスタイルシートを取得する場合で、値が違うのを確認しましょう。

<!-- このコードは編集できます。 -->

<!DOCTYPE html>
<head>
<style>
div#result { white-space: pre-wrap ; }
</style>
</head>
<body>
<p id="hoge" style="color:black;">SYNCER</p>
<hr>
<div id="result"></div>
<script>
var element = document.getElementById( "hoge" ) ;
var cssStyleDeclaration = element.style ;	// style属性の場合
// var cssStyleDeclaration = getComputedStyle( element ) ;	// 計算値の場合

// 代入
// cssStyleDeclaration.cssText = "color:red; font-weight: 700;" ;

// 取得
var value = cssStyleDeclaration.cssText ;
console.log( value ) ;
appendText( value ) ;

function appendText( text ) {
	document.getElementById( "result" ).appendChild( document.createTextNode( text ) ) ; 
}
</script>
</body>
</html>