-
- All Superinterfaces:
-
CSSValue
public interface CSSPrimitiveValue extends CSSValue
CSSPrimitiveValue
接口表示单个CSS值。 此接口可用于确定当前在块中设置的特定样式属性的值,或者在块中显式设置特定样式属性。 可以从CSSStyleDeclaration
接口的getPropertyCSSValue
方法获得该接口的实例。CSSPrimitiveValue
对象仅出现在CSS属性的上下文中。绝对值之间允许转换(从毫米到厘米,从度到弧度,依此类推),但不允许在相对值之间。 (例如,像素值无法转换为厘米值。)百分比值无法转换,因为它们相对于父值(或其他属性值)。 颜色百分比值有一个例外:由于颜色百分比值相对于0-255的范围,颜色百分比值可以转换为数字; (另请参阅
RGBColor
界面)。- 从以下版本开始:
- 1.4,DOM Level 2
-
-
字段汇总
字段 变量和类型 字段 描述 static short
CSS_ATTR
该值是属性函数。static short
CSS_CM
该值是长度(cm)。static short
CSS_COUNTER
该值是计数器或计数器功能。static short
CSS_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
该值是一个时间。static short
CSS_STRING
该值为STRING。static short
CSS_UNKNOWN
该值不是可识别的CSS2值。static short
CSS_URI
该值是一个URI。-
Fields declared in interface org.w3c.dom.css.CSSValue
CSS_CUSTOM, CSS_INHERIT, CSS_PRIMITIVE_VALUE, CSS_VALUE_LIST
-
-
方法摘要
所有方法 实例方法 抽象方法 变量和类型 方法 描述 Counter
getCounterValue()
此方法用于获取Counter值。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
该值是角度(度)。 可以使用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
该值是一个时间。 可以使用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
该值为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:如果附加属性不支持浮点值或单元类型,则DOMException
。
NO_MODIFICATION_ALLOWED_ERR:如果此属性是只读的,则引发此异常。
-
getFloatValue
float getFloatValue(short unitType) throws DOMException
此方法用于获取指定单位的浮点值。 如果此CSS值不包含浮点值或无法转换为指定的单位,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
)。 - 结果
- 指定单位中的浮点值。
- 异常
-
DOMException
- INVALID_ACCESS_ERR:如果CSS值不包含浮点值或浮点值无法转换为指定单位,则DOMException
。
-
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值不包含字符串值或者字符串值无法转换为指定单位,则DOMException
。
NO_MODIFICATION_ALLOWED_ERR:如果此属性是只读的,则引发此异常。
-
getStringValue
String getStringValue() throws DOMException
此方法用于获取字符串值。 如果CSS值不包含字符串值,则引发DOMException
。 某些属性(如'font-family'或'voice-family')将以空格分隔的ident列表转换为字符串。- 结果
-
当前单位中的字符串值。
当前
primitiveType
只能是一个字符串单元类型(即CSS_STRING
,CSS_URI
,CSS_IDENT
和CSS_ATTR
)。 - 异常
-
DOMException
- INVALID_ACCESS_ERR:如果CSS值不包含字符串值,则DOMException
。
-
getCounterValue
Counter getCounterValue() throws DOMException
此方法用于获取Counter值。 如果此CSS值不包含计数器值,则引发DOMException
。 使用Counter
接口可以实现对相应样式属性的修改。- 结果
- 计数器值。
- 异常
-
DOMException
- INVALID_ACCESS_ERR:如果CSS值不包含Counter值(例如,这不是CSS_COUNTER
),则CSS_COUNTER
此CSS_COUNTER
。
-
getRectValue
Rect getRectValue() throws DOMException
此方法用于获取Rect值。 如果此CSS值不包含rect值,则引发DOMException
。 可以使用Rect
接口修改相应的样式属性。- 结果
- Rect值。
- 异常
-
DOMException
- INVALID_ACCESS_ERR:如果CSS值不包含Rect值,则DOMException
。 (例如,这不是CSS_RECT
)。
-
getRGBColorValue
RGBColor getRGBColorValue() throws DOMException
此方法用于获取RGB颜色。 如果此CSS值不包含RGB颜色值,DOMException
引发DOMException
。 使用RGBColor
接口可以实现对相应样式属性的修改。- 结果
- RGB颜色值。
- 异常
-
DOMException
- INVALID_ACCESS_ERR:如果附加属性无法返回RGB颜色值(例如,这不是CSS_RGBCOLOR
),则CSS_RGBCOLOR
此CSS_RGBCOLOR
。
-
-