モジュール 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 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ではない場合など)に発生する。