モジュール jdk.xml.dom
パッケージ org.w3c.dom.css

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

    • フィールドの詳細

      • 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ではない場合など)に発生する。