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);
};