CSSPrimitiveValue インターフェイスは単一の CSS value を表す。このインターフェイスによって、ブロック内の特定のスタイルプロパティ値の現在の設定が定義されたり、またブロック内の特定のスタイルプロパティが明示的な設定されることがある。このインターフェイスのインスタンスは CSSStyleDeclaration インターフェイスの getPropertyCSSValue メソッドから取得される。CSSPrimitiveValue オブジェクトは CSS プロパティのコンテキスト内にのみ出現する。
絶対値間の換算は許されている(ミリメートルからセンチメートルへ、角度からラジアンへ、等)が、相対値間についてはそうではない。(例えば、ピクセル値をセンチメートルに換算はできない。) パーセント値はその関連する親の値(あるいは他のプロパティ値)から換算されない。例外は色のパーセント値である: 単一の色のパーセント値は 0-255 の範囲に対応している。従って、色のパーセント値は数値に変換が可能である。(RGBColor インターフェイスも参照すること)。
値に適用される単位型を示す整数。
| CSS_ATTR | この値は、属性関数(attribute function) である。getStringValue メソッドによって取得される。 |
| CSS_CM | この値は 長さ(length (cm)) である。getFloatValue メソッドによって取得される。 |
| CSS_COUNTER | この値は カウンタ、カウンタ関数(counter or counters function) である。getCounterValue メソッドによって取得される。 |
| CSS_DEG | この値は 角度(angle (deg)) である。getFloatValue メソッドによって取得される。 |
| CSS_DIMENSION | この値は未知の大きさの数値である。getFloatValue メソッドによって取得される。 |
| CSS_EMS | この値は 長さ(length (ems)) である。getFloatValue メソッドによって取得される。 |
| CSS_EXS | この値は 長さ(length (exs)) である。getFloatValue メソッドによって取得される。 |
| CSS_GRAD | この値は 角度(angle (grad)) である。getFloatValue メソッドによって取得される。 |
| CSS_HZ | この値は 周波数(frequency (Hz)) である。getFloatValue メソッドによって取得される。 |
| CSS_IDENT | この値は 識別子(identifier) である。getStringValue メソッドによって取得される。 |
| CSS_IN | この値は 長さ(in) である。この値は getFloatValue メソッドによって取得される。 |
| CSS_KHZ | この値は 周波数(KHz) である。getFloatValue メソッドによって取得される。 |
| CSS_MM | この値は 長さ(length (mm)) である。getFloatValue メソッドによって取得される。 |
| CSS_MS | この値は 時間(time(ms)) である。getFloatValue メソッドによって取得される。 |
| CSS_NUMBER | この値は単純な 数(number) である。getFloatValue メソッドによって取得される。 |
| CSS_PC | この値は 長さ(length (pc)) である。getFloatValue メソッドによって取得される。 |
| CSS_PERCENTAGE | この値は パーセント(percentage) である。getFloatValue メソッドによって取得される。 |
| CSS_PT | この値は 長さ(length (pt)) である。getFloatValue メソッドによって取得される。 |
| CSS_PX | この値は 長さ(length (px)) である。getFloatValue メソッドによって取得される。 |
| CSS_RAD | この値は 角度(angle (rad)) である。getFloatValue メソッドによって取得される。 |
| CSS_RECT | この値は 矩形関数(rexct function) である。getRectValue メソッドによって取得される。 |
| CSS_RGBCOLOR | この値は RGBカラー(RGB color) である。getRGBColorValue メソッドによって取得される。 |
| CSS_S | この値は 時間(time (s)) である。getFloatValue メソッドによって取得される。 |
| CSS_STRING | この値は 文字列(STRING) である。getStringValue メソッドによって取得される。 |
| CSS_UNKNOWN | この値は CSS2 では認識されない。cssText プロパティでのみ取得される。 |
| CSS_URI | この値は URI である。getStringValue メソッドによって取得される。 |
primitiveTypeunsigned short型, 読取専用
getCounterValue( )カウンタ値を取得する。CSS 値がカウンタ値を含まない場合は DOMException が発生する。Counter インターフェイスを使用して該当するスタイルプロパティを変更する。
Counter 型。カウンタ値
CSS_COUNTER でないなど、CSS 値がカウンタ値でない場合に発生。getFloatValue( unitType )指定の単位のフロート値を取得する。CSS 値がフロート値を含まない場合、また指定の単位に変換できない場合は DOMException が発生。
CSS_NUMBER,
CSS_PERCENTAGE, CSS_EMS,
CSS_EXS, CSS_PX, CSS_CM,
CSS_MM, CSS_IN, CSS_PT,
CSS_PC, CSS_DEG, CSS_RAD,
CSS_GRAD, CSS_MS, CSS_S,
CSS_HZ, CSS_KHZ,
CSS_DIMENSION) のみ可能。float 型。指定の単位のフロート値。
getRGBColorValue( )RGBカラーを取得する。CSS 値が RGB カラーを含まない場合、DOMException が発生する。RGBColor インターフェイスを使用して該当するスタイルプロパティを変更する。
RGBColor 型。RGB カラー値。
CSS_RGBCOLOR でないなど、付属するプロパティが RGB カラー値を返せない場合に発生。getRectValue( )矩形値を取得する。CSS 値が矩形値を含まない場合、DOMException が発生する。Rect インターフェイスを使用して該当するスタイルプロパティを変更する。
Rect 型。矩形値
CSS_RECT でないなど、CSS 値が矩形値を含まない場合に発生。getStringValue( )文字列値を取得する。CSS 値が文字列値を含まない場合、DOMException が発生。
Note: 空白で区切られた識別子のリストを文字列に変換するプロパティ('font-family' や 'voice-family' など) もある。
DOMString 型。現在の単位の文字列値。現在の primitiveType は文字列単位型としてのみ取得できる。(つまり CSS_STRING, CSS_URI,
CSS_IDENT, CSS_ATTR)
setFloatValue( unitType, floatValue )指定の単位のフロート値を設定するメソッド。値に付属するプロパティが指定単位またはフロート値を受け付けない場合、値は変更されず DOMException が発生する。
CSS_NUMBER,
CSS_PERCENTAGE, CSS_EMS,
CSS_EXS, CSS_PX, CSS_CM,
CSS_MM, CSS_IN, CSS_PT,
CSS_PC, CSS_DEG, CSS_RAD,
CSS_GRAD, CSS_MS, CSS_S,
CSS_HZ, CSS_KHZ,
CSS_DIMENSION)のみ可能。
(無し)
setStringValue( stringType, stringValue )指定単位の文字列値を設定する。値の属するプロパティが指定単位または文字列値を受け付けない場合、値は変更されず、DOMException が発生する。
CSS_STRING,
CSS_URI, CSS_IDENT, and
CSS_ATTR)のみ取りうる。
(無し)
// Introduced in DOM Level 2:
interface CSSPrimitiveValue : CSSValue {
// UnitTypes
const unsigned short CSS_UNKNOWN = 0;
const unsigned short CSS_NUMBER = 1;
const unsigned short CSS_PERCENTAGE = 2;
const unsigned short CSS_EMS = 3;
const unsigned short CSS_EXS = 4;
const unsigned short CSS_PX = 5;
const unsigned short CSS_CM = 6;
const unsigned short CSS_MM = 7;
const unsigned short CSS_IN = 8;
const unsigned short CSS_PT = 9;
const unsigned short CSS_PC = 10;
const unsigned short CSS_DEG = 11;
const unsigned short CSS_RAD = 12;
const unsigned short CSS_GRAD = 13;
const unsigned short CSS_MS = 14;
const unsigned short CSS_S = 15;
const unsigned short CSS_HZ = 16;
const unsigned short CSS_KHZ = 17;
const unsigned short CSS_DIMENSION = 18;
const unsigned short CSS_STRING = 19;
const unsigned short CSS_URI = 20;
const unsigned short CSS_IDENT = 21;
const unsigned short CSS_ATTR = 22;
const unsigned short CSS_COUNTER = 23;
const unsigned short CSS_RECT = 24;
const unsigned short CSS_RGBCOLOR = 25;
readonly attribute unsigned short primitiveType;
void setFloatValue(in unsigned short unitType,
in float floatValue)
raises(DOMException);
float getFloatValue(in unsigned short unitType)
raises(DOMException);
void setStringValue(in unsigned short stringType,
in DOMString stringValue)
raises(DOMException);
DOMString getStringValue()
raises(DOMException);
Counter getCounterValue()
raises(DOMException);
Rect getRectValue()
raises(DOMException);
RGBColor getRGBColorValue()
raises(DOMException);
};