-
- All Superinterfaces:
-
CSSValue
public interface CSSPrimitiveValue extends CSSValue
CSSPrimitiveValue
接口表示单个CSS值。 此接口可用于确定块中当前设置的特定样式属性的值或在块中显式设置特定样式属性。 可以从CSSStyleDeclaration
接口的getPropertyCSSValue
方法获取此接口的实例。 一个CSSPrimitiveValue
对象只发生在CSS属性的上下文中。允许绝对值(从毫米到厘米,从度数到弧度等)之间进行转换,但不允许在相对值之间进行转换。 (例如,像素值不能转换为厘米值。)百分比值不能转换,因为它们相对于父值(或另一个属性值)。 颜色百分比值有一个例外:由于颜色百分比值相对于范围0-255,颜色百分比值可以转换为数字; (另见
RGBColor
界面)。- 从以下版本开始:
- 1.4,DOM Level 2
-
-
Field Summary
Fields Modifier and Type Field 描述 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
该值是一个长度(英寸)。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 inherited from interface org.w3c.dom.css.CSSValue
CSS_CUSTOM, CSS_INHERIT, CSS_PRIMITIVE_VALUE, CSS_VALUE_LIST
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 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)
用指定单位设置字符串值的方法。-
Methods inherited from interface org.w3c.dom.css.CSSValue
getCssText, getCssValueType, setCssText
-
-
-
-
字段详细信息
-
CSS_UNKNOWN
static final short CSS_UNKNOWN
该值不是公认的CSS2值。 该值只能通过使用cssText
属性获得。- 另请参见:
- Constant Field Values
-
CSS_NUMBER
static final short CSS_NUMBER
该值是一个简单的数字。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_PERCENTAGE
static final short CSS_PERCENTAGE
该值是一个百分比。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_EMS
static final short CSS_EMS
值是一个长度(ems)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_EXS
static final short CSS_EXS
该值是一个长度(exs)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_PX
static final short CSS_PX
该值为长度(px)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_CM
static final short CSS_CM
该值为长度(cm)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_MM
static final short CSS_MM
值为长度(mm)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_IN
static final short CSS_IN
该值是一个长度(英寸)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_PT
static final short CSS_PT
该值为长度(pt)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_PC
static final short CSS_PC
该值是一个长度(pc)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_DEG
static final short CSS_DEG
该值是一个角度(度)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_RAD
static final short CSS_RAD
该值为角度(rad)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_GRAD
static final short CSS_GRAD
该值是一个角度(grad)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_MS
static final short CSS_MS
该值是一个时间(ms)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_S
static final short CSS_S
该值是一个时间。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_HZ
static final short CSS_HZ
该值为频率(Hz)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_KHZ
static final short CSS_KHZ
该值为频率(kHz)。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_DIMENSION
static final short CSS_DIMENSION
该值是具有未知维度的数字。 该值可以通过使用getFloatValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_STRING
static final short CSS_STRING
该值为STRING。 该值可以通过使用getStringValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_URI
static final short CSS_URI
该值是一个URI。 该值可以通过使用getStringValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_IDENT
static final short CSS_IDENT
该值是一个标识符。 该值可以通过使用getStringValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_ATTR
static final short CSS_ATTR
该值是属性函数。 该值可以通过使用getStringValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_COUNTER
static final short CSS_COUNTER
该值是计数器或计数器功能。 该值可以通过使用getCounterValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_RECT
static final short CSS_RECT
该值是一个rect函数。 该值可以通过使用getRectValue
方法获得。- 另请参见:
- Constant Field Values
-
CSS_RGBCOLOR
static final short CSS_RGBCOLOR
该值为RGB颜色。 该值可以通过使用getRGBColorValue
方法获得。- 另请参见:
- Constant Field Values
-
-
方法详细信息
-
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
引发DOMException
。 一些属性(如“font-family”或“voice-family”)将空格分隔的idents列表转换为字符串。- 结果
-
当前单位的字符串值。
当前
primitiveType
只能是一个字符串单元类型(即CSS_STRING
,CSS_URI
,CSS_IDENT
和CSS_ATTR
)。 - 异常
-
DOMException
- INVALID_ACCESS_ERR:如果CSS值不包含字符串值,则DOMException
。
-
getCounterValue
Counter getCounterValue() throws DOMException
该方法用于获取计数器值。 如果此CSS值不包含计数器值,DOMException
引发DOMException
。 可以使用Counter
界面修改相应的样式属性。- 结果
- 计数器值。
- 异常
-
DOMException
- INVALID_ACCESS_ERR:如果CSS值不包含计数器值(例如,不是CSS_COUNTER
)则CSS_COUNTER
。
-
getRectValue
Rect getRectValue() throws DOMException
此方法用于获取Rect值。 如果此CSS值不包含rect值,DOMException
引发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
。
-
-