インタフェースCSSPrimitiveValue

すべてのスーパー・インタフェース:
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 final short
    CSS_ATTR
    値は属性関数です。
    static final short
    CSS_CM
    値は長さ(cm)です。
    static final short
    CSS_COUNTER
    値は、カウンタまたはカウンタ関数です。
    static final short
    CSS_DEG
    値は角度(deg)です。
    static final short
    CSS_DIMENSION
    値は、寸法が不明な数値です。
    static final short
    CSS_EMS
    値は長さ(ems)です。
    static final short
    CSS_EXS
    値は長さ(exs)です。
    static final short
    CSS_GRAD
    値は角度(grad)です。
    static final short
    CSS_HZ
    値は周波数(Hz)です。
    static final short
    CSS_IDENT
    値は識別子です。
    static final short
    CSS_IN
    値は長さ(in)です。
    static final short
    CSS_KHZ
    値は周波数(kHz)です。
    static final short
    CSS_MM
    値は長さ(mm)です。
    static final short
    CSS_MS
    値は時間(ms)です。
    static final short
    CSS_NUMBER
    値は単純な数値です。
    static final short
    CSS_PC
    値は長さ(pc)です。
    static final short
    CSS_PERCENTAGE
    値はパーセントです。
    static final short
    CSS_PT
    値は長さ(pt)です。
    static final short
    CSS_PX
    値は長さ(px)です。
    static final short
    CSS_RAD
    値は角度(rad)です。
    static final short
    CSS_RECT
    値はRect関数です。
    static final short
    CSS_RGBCOLOR
    値はRGBカラーです。
    static final short
    CSS_S
    値は時間(s)です。
    static final short
    CSS_STRING
    値は文字列です。
    static final short
    CSS_UNKNOWN
    CSS2の値として認識できない値です。
    static final short
    CSS_URI
    値はURIです。

    インタフェースorg.w3c.dom.css.CSSValueで宣言されているフィールド

    CSS_CUSTOM, CSS_INHERIT, CSS_PRIMITIVE_VALUE, CSS_VALUE_LIST

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    Counter
    getCounterValue()
    このメソッドは、カウンタ値を取得するために使用します。
    float
    getFloatValue(short unitType)
    このメソッドは、指定した単位の浮動小数点値を取得するために使用します。
    short
    getPrimitiveType()
    前述の定数によって定義される、値の種類です。
    Rect
    getRectValue()
    このメソッドは、Rect値を取得するために使用します。
    RGBColor
    getRGBColorValue()
    このメソッドは、RGBカラーを取得するために使用します。
    String
    getStringValue()
    このメソッドは、文字列値を取得するために使用します。
    void
    setFloatValue(short unitType, float floatValue)
    指定した単位で浮動小数点値を設定するメソッドです。
    void
    setStringValue(short stringType, String stringValue)
    指定した単位で文字列値を設定するメソッドです。

    インタフェースorg.w3c.dom.css.CSSValueで宣言されたメソッド

    getCssText, getCssValueType, setCssText

  • フィールド詳細

    • CSS_UNKNOWN

      static final short CSS_UNKNOWN
      CSS2の値として認識できない値です。 この値を取得するには、cssText属性を使用するしか方法がありません。
      関連項目:

    • CSS_NUMBER

      static final short CSS_NUMBER
      値は単純な数値です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_PERCENTAGE

      static final short CSS_PERCENTAGE
      値はパーセントです。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_EMS

      static final short CSS_EMS
      値は長さ(ems)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_EXS

      static final short CSS_EXS
      値は長さ(exs)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_PX

      static final short CSS_PX
      値は長さ(px)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_CM

      static final short CSS_CM
      値は長さ(cm)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_MM

      static final short CSS_MM
      値は長さ(mm)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_IN

      static final short CSS_IN
      値は長さ(in)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_PT

      static final short CSS_PT
      値は長さ(pt)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_PC

      static final short CSS_PC
      値は長さ(pc)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_DEG

      static final short CSS_DEG
      値は角度(deg)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_RAD

      static final short CSS_RAD
      値は角度(rad)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_GRAD

      static final short CSS_GRAD
      値は角度(grad)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_MS

      static final short CSS_MS
      値は時間(ms)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_S

      static final short CSS_S
      値は時間(s)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_HZ

      static final short CSS_HZ
      値は周波数(Hz)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_KHZ

      static final short CSS_KHZ
      値は周波数(kHz)です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_DIMENSION

      static final short CSS_DIMENSION
      値は、寸法が不明な数値です。 この値は、getFloatValueメソッドを使用して取得できます。
      関連項目:

    • CSS_STRING

      static final short CSS_STRING
      値は文字列です。 この値は、getStringValueメソッドを使用して取得できます。
      関連項目:

    • CSS_URI

      static final short CSS_URI
      値はURIです。 この値は、getStringValueメソッドを使用して取得できます。
      関連項目:

    • CSS_IDENT

      static final short CSS_IDENT
      値は識別子です。 この値は、getStringValueメソッドを使用して取得できます。
      関連項目:

    • CSS_ATTR

      static final short CSS_ATTR
      値は属性関数です。 この値は、getStringValueメソッドを使用して取得できます。
      関連項目:

    • CSS_COUNTER

      static final short CSS_COUNTER
      値は、カウンタまたはカウンタ関数です。 この値は、getCounterValueメソッドを使用して取得できます。
      関連項目:

    • CSS_RECT

      static final short CSS_RECT
      値はRect関数です。 この値は、getRectValueメソッドを使用して取得できます。
      関連項目:

    • CSS_RGBCOLOR

      static final short CSS_RGBCOLOR
      値はRGBカラーです。 この値は、getRGBColorValueメソッドを使用して取得できます。
      関連項目:

  • メソッドの詳細

    • getPrimitiveType

      short getPrimitiveType()
      前述の定数によって定義される、値の種類です。

    • setFloatValue

      void 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: このプロパティが読取り専用の場合に発生する。

    • getFloatValue

      float 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値に浮動小数点値が含まれていない場合、または浮動小数点値を指定された単位に変換できない場合に発生する

    • setStringValue

      void 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: このプロパティが読取り専用の場合に発生する。

    • getStringValue

      String getStringValue() throws DOMException
      このメソッドは、文字列値を取得するために使用します。 CSS値に文字列値が含まれていない場合には、DOMExceptionが発生します。 一部のプロパティ(font-familyやvoice-familyなど)では、空白で区切られた識別子のリストが文字列に変換されます。
      戻り値:
      現在の単位での文字列値。 現在のprimitiveTypeとしては、文字列型の単位の種類だけが可能(つまり、CSS_STRING、CSS_URI、CSS_IDENT、およびCSS_ATTR)。
      スロー:
      DOMException - INVALID_ACCESS_ERR: CSS値に文字列値が含まれていない場合に発生する。

    • getCounterValue

      Counter getCounterValue() throws DOMException
      このメソッドは、カウンタ値を取得するために使用します。 このCSS値にカウンタ値が含まれていない場合には、DOMExceptionが発生します。 対応するスタイル・プロパティを変更するには、Counterインタフェースを使用します。
      戻り値:
      カウンタ値
      スロー:
      DOMException - INVALID_ACCESS_ERR: CSS値にカウンタ値が含まれていない場合(CSS値がCSS_COUNTERではない場合など)に発生する。

    • getRectValue

      Rect getRectValue() throws DOMException
      このメソッドは、Rect値を取得するために使用します。 このCSS値にRect値が含まれていない場合には、DOMExceptionが発生します。 対応するスタイル・プロパティを変更するには、Rectインタフェースを使用します。
      戻り値:
      Rect値
      スロー:
      DOMException - INVALID_ACCESS_ERR: CSS値にRect値が含まれていない場合(これがCSS_RECTではない場合など)に発生する。

    • getRGBColorValue

      RGBColor getRGBColorValue() throws DOMException
      このメソッドは、RGBカラーを取得するために使用します。 このCSS値にRGBカラー値が含まれていない場合には、DOMExceptionが発生します。 対応するスタイル・プロパティを変更するには、RGBColorインタフェースを使用します。
      戻り値:
      RGBカラー値
      スロー:
      DOMException - INVALID_ACCESS_ERR: 結び付けられたプロパティが、RGBカラー値を返すことができない場合(これがCSS_RGBCOLORではない場合など)に発生する。