- すべてのスーパー・インタフェース:
- CSSValue
public interface CSSPrimitiveValue extends CSSValue
CSSPrimitiveValueインタフェースは、単一のCSS値を表します。 このインタフェースは、ブロック内で現在設定されている特定のスタイル・プロパティの値を判別したり、ブロック内に特定のスタイル・プロパティを明示的に指定したりするために使用できます。 このインタフェースのインスタンスは、CSSStyleDeclarationインタフェースのgetPropertyCSSValueメソッドから取得できます。 CSSPrimitiveValueオブジェクトは、CSSプロパティのコンテキストにのみ出現します。 
  絶対値間での変換(mmからcm、度からラジアンなど)は可能ですが、相対値間での変換(ピクセル値からcmなど)はできません。 また、パーセント値は、親値(または別のプロパティ値)に対する相対的な値なので、変換できません。 ただし、色のパーセント値は例外です。 色のパーセント値は0 - 255の範囲に対する相対値なので、色のパーセント値は数値に変換できます(RGBColorインタフェースも参照)。 
 
「Document Object Model (DOM) Level 2 Style Specification」も参照してください。
- 導入されたバージョン:
- 1.4、DOMレベル2
- 
フィールドのサマリーフィールド 修飾子と型 フィールド 説明 static shortCSS_ATTR値は属性関数です。static shortCSS_CM値は長さ(cm)です。static shortCSS_COUNTER値は、カウンタまたはカウンタ関数です。static shortCSS_DEG値は角度(deg)です。static shortCSS_DIMENSION値は、寸法が不明な数値です。static shortCSS_EMS値は長さ(ems)です。static shortCSS_EXS値は長さ(exs)です。static shortCSS_GRAD値は角度(grad)です。static shortCSS_HZ値は周波数(Hz)です。static shortCSS_IDENT値は識別子です。static shortCSS_IN値は長さ(in)です。static shortCSS_KHZ値は周波数(kHz)です。static shortCSS_MM値は長さ(mm)です。static shortCSS_MS値は時間(ms)です。static shortCSS_NUMBER値は単純な数値です。static shortCSS_PC値は長さ(pc)です。static shortCSS_PERCENTAGE値はパーセントです。static shortCSS_PT値は長さ(pt)です。static shortCSS_PX値は長さ(px)です。static shortCSS_RAD値は角度(rad)です。static shortCSS_RECT値はRect関数です。static shortCSS_RGBCOLOR値はRGBカラーです。static shortCSS_S値は時間(s)です。static shortCSS_STRING値は文字列です。static shortCSS_UNKNOWNCSS2の値として認識できない値です。static shortCSS_URI値はURIです。インタフェース org.w3c.dom.css.CSSValueで宣言されたフィールドCSS_CUSTOM, CSS_INHERIT, CSS_PRIMITIVE_VALUE, CSS_VALUE_LIST
- 
メソッドのサマリー修飾子と型 メソッド 説明 CountergetCounterValue()このメソッドは、カウンタ値を取得するために使用します。floatgetFloatValue(short unitType)このメソッドは、指定した単位の浮動小数点値を取得するために使用します。shortgetPrimitiveType()前述の定数によって定義される、値の種類です。RectgetRectValue()このメソッドは、Rect値を取得するために使用します。RGBColorgetRGBColorValue()このメソッドは、RGBカラーを取得するために使用します。StringgetStringValue()このメソッドは、文字列値を取得するために使用します。voidsetFloatValue(short unitType, float floatValue)指定した単位で浮動小数点値を設定するメソッドです。voidsetStringValue(short stringType, String stringValue)指定した単位で文字列値を設定するメソッドです。
- 
フィールド詳細- 
CSS_UNKNOWNstatic final short CSS_UNKNOWNCSS2の値として認識できない値です。 この値を取得するには、cssText属性を使用するしか方法がありません。- 関連項目:
- 定数フィールド値
 
- 
CSS_NUMBERstatic final short CSS_NUMBER値は単純な数値です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_PERCENTAGEstatic final short CSS_PERCENTAGE値はパーセントです。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_EMSstatic final short CSS_EMS値は長さ(ems)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_EXSstatic final short CSS_EXS値は長さ(exs)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_PXstatic final short CSS_PX値は長さ(px)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_CMstatic final short CSS_CM値は長さ(cm)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_MMstatic final short CSS_MM値は長さ(mm)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_INstatic final short CSS_IN値は長さ(in)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_PTstatic final short CSS_PT値は長さ(pt)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_PCstatic final short CSS_PC値は長さ(pc)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_DEGstatic final short CSS_DEG値は角度(deg)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_RADstatic final short CSS_RAD値は角度(rad)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_GRADstatic final short CSS_GRAD値は角度(grad)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_MSstatic final short CSS_MS値は時間(ms)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_Sstatic final short CSS_S値は時間(s)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_HZstatic final short CSS_HZ値は周波数(Hz)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_KHZstatic final short CSS_KHZ値は周波数(kHz)です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_DIMENSIONstatic final short CSS_DIMENSION値は、寸法が不明な数値です。 この値は、getFloatValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_STRINGstatic final short CSS_STRING値は文字列です。 この値は、getStringValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_URIstatic final short CSS_URI値はURIです。 この値は、getStringValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_IDENTstatic final short CSS_IDENT値は識別子です。 この値は、getStringValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_ATTRstatic final short CSS_ATTR値は属性関数です。 この値は、getStringValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_COUNTERstatic final short CSS_COUNTER値は、カウンタまたはカウンタ関数です。 この値は、getCounterValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_RECTstatic final short CSS_RECT値はRect関数です。 この値は、getRectValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
- 
CSS_RGBCOLORstatic final short CSS_RGBCOLOR値はRGBカラーです。 この値は、getRGBColorValueメソッドを使用して取得できます。- 関連項目:
- 定数フィールド値
 
 
- 
- 
メソッドの詳細- 
getPrimitiveTypeshort getPrimitiveType()前述の定数によって定義される、値の種類です。
- 
setFloatValuevoid setFloatValue(short unitType, float floatValue) throws DOMException指定した単位で浮動小数点値を設定するメソッドです。 この値が結び付けられるプロパティに、指定した単位または浮動小数点値が受け入れられない場合、値は変更されずにDOMExceptionが発生します。- パラメータ:
- unitType- 前述の単位コード。 指定できるのは、浮動小数点型の単位の種類のみ(つまり、- 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)です。
- floatValue-新しい浮動小数点値。
- 例外:
- DOMException- INVALID_ACCESS_ERR: 結び付けられたプロパティが、浮動小数点値または単位の種類をサポートしていない場合に発生する。
 NO_MODIFICATION_ALLOWED_ERR: このプロパティが読取り専用の場合に発生する。
 
- 
getFloatValuefloat getFloatValue(short unitType) throws DOMExceptionこのメソッドは、指定した単位の浮動小数点値を取得するために使用します。 このCSS値に浮動小数点値が含まれていない場合、または指定された単位に変換できない場合には、DOMExceptionが発生します。- パラメータ:
- unitType- 浮動小数点値を取得するための単位コード。 指定できるのは、浮動小数点型の単位の種類のみ(つまり、- 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)です。
- 戻り値:
- 指定された単位での浮動小数点値
- 例外:
- DOMException- INVALID_ACCESS_ERR: CSS値に浮動小数点値が含まれていない場合、または浮動小数点値を指定された単位に変換できない場合に発生する
 
- 
setStringValuevoid setStringValue(short stringType, String stringValue) throws DOMException指定した単位で文字列値を設定するメソッドです。 この値が結び付けられるプロパティが、指定した単位または文字列値を受け入れることができない場合、値は変更されずに、DOMExceptionが発生します。- パラメータ:
- stringType- 前述の文字列コード。 指定できる文字列コードは、文字列型の単位の種類のみ(つまり、- CSS_STRING、- CSS_URI、- CSS_IDENT、および- CSS_ATTR)。
- stringValue- 新しい文字列値。
- 例外:
- DOMException- INVALID_ACCESS_ERR: CSS値に文字列値が含まれていない場合、または文字列値を指定された単位に変換できない場合に発生する。
 NO_MODIFICATION_ALLOWED_ERR: このプロパティが読取り専用の場合に発生する。
 
- 
getStringValueString getStringValue() throws DOMExceptionこのメソッドは、文字列値を取得するために使用します。 CSS値に文字列値が含まれていない場合には、DOMExceptionが発生します。 一部のプロパティ(font-familyやvoice-familyなど)では、空白で区切られた識別子のリストが文字列に変換されます。- 戻り値:
- 現在の単位での文字列値。 現在のprimitiveTypeとしては、文字列型の単位の種類だけが可能(つまり、CSS_STRING、CSS_URI、CSS_IDENT、およびCSS_ATTR)。
- 例外:
- DOMException- INVALID_ACCESS_ERR: CSS値に文字列値が含まれていない場合に発生する。
 
- 
getCounterValueCounter getCounterValue() throws DOMExceptionこのメソッドは、カウンタ値を取得するために使用します。 このCSS値にカウンタ値が含まれていない場合には、DOMExceptionが発生します。 対応するスタイル・プロパティを変更するには、Counterインタフェースを使用します。- 戻り値:
- カウンタ値
- 例外:
- DOMException- INVALID_ACCESS_ERR: CSS値にカウンタ値が含まれていない場合(CSS値が- CSS_COUNTERではない場合など)に発生する。
 
- 
getRectValueRect getRectValue() throws DOMExceptionこのメソッドは、Rect値を取得するために使用します。 このCSS値にRect値が含まれていない場合には、DOMExceptionが発生します。 対応するスタイル・プロパティを変更するには、Rectインタフェースを使用します。- 戻り値:
- Rect値
- 例外:
- DOMException- INVALID_ACCESS_ERR: CSS値にRect値が含まれていない場合(これが- CSS_RECTではない場合など)に発生する。
 
- 
getRGBColorValueRGBColor getRGBColorValue() throws DOMExceptionこのメソッドは、RGBカラーを取得するために使用します。 このCSS値にRGBカラー値が含まれていない場合には、DOMExceptionが発生します。 対応するスタイル・プロパティを変更するには、RGBColorインタフェースを使用します。- 戻り値:
- RGBカラー値
- 例外:
- DOMException- INVALID_ACCESS_ERR: 結び付けられたプロパティが、RGBカラー値を返すことができない場合(これが- CSS_RGBCOLORではない場合など)に発生する。
 
 
-