Module jdk.xml.dom
Package org.w3c.dom.css

Interface CSSPrimitiveValue

所有超级接口:
CSSValue
public interface CSSPrimitiveValue extends CSSValue
CSSPrimitiveValue接口表示单个CSS值。此接口可用于确定当前在块中设置的特定样式属性的值，或者在块内显式设置特定样式属性。可以通过CSSStyleDeclaration接口的getPropertyCSSValue方法获取此接口的实例。 CSSPrimitiveValue对象仅出现在CSS属性的上下文中。

允许在绝对值之间进行转换（从毫米到厘米，从度到弧度等），但不能在相对值之间进行转换（例如，像素值不能转换为厘米值）。百分比值不能转换，因为它们是相对于父值（或另一个属性值）的。对于颜色百分比值有一个例外：由于颜色百分比值是相对于范围0-255的，因此颜色百分比值可以转换为数字；（另请参见RGBColor接口）。

另请参见文档对象模型（DOM）Level 2 样式规范。

自从:
1.4, DOM Level 2

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final short
    CSS_ATTR
    该值是一个属性函数。
    static final short
    CSS_CM
    该值是一个长度（厘米）。
    static final short
    CSS_COUNTER
    该值是一个计数器或计数器函数。
    static final short
    CSS_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
    该值是一个长度（英寸）。
    static final short
    CSS_KHZ
    该值是一个频率（kHz）。
    static final short
    CSS_MM
    该值是一个长度（毫米）。
    static final short
    CSS_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
    该值是一个长度（像素）。
    static final short
    CSS_RAD
    该值是一个角度（弧度）。
    static final short
    CSS_RECT
    该值是一个矩形函数。
    static final short
    CSS_RGBCOLOR
    该值是一个RGB颜色。
    static final short
    CSS_S
    该值是一个时间（秒）。
    static final short
    CSS_STRING
    该值是一个字符串。
    static final short
    CSS_UNKNOWN
    该值不是一个被识别的CSS2值。
    static final short
    CSS_URI
    该值是一个URI。

    Fields declared in interface org.w3c.dom.css.CSSValue

    CSS_CUSTOM, CSS_INHERIT, CSS_PRIMITIVE_VALUE, CSS_VALUE_LIST

  • Method Summary

    Modifier and Type
    Method
    Description
    Counter
    getCounterValue()
    该方法用于获取计数器值。
    float
    getFloatValue(short unitType)
    该方法用于获取指定单位中的浮点值。
    short
    getPrimitiveType()
    由上面指定的常量定义的值类型。
    Rect
    getRectValue()
    该方法用于获取矩形值。
    RGBColor
    getRGBColorValue()
    该方法用于获取RGB颜色。
    String
    getStringValue()
    该方法用于获取字符串值。
    void
    setFloatValue(short unitType, float floatValue)
    用指定单位设置浮点值的方法。
    void
    setStringValue(short stringType, String stringValue)
    用指定单位设置字符串值的方法。

    Methods declared in interface org.w3c.dom.css.CSSValue

    getCssText, getCssValueType, setCssText

  • Field Details

    • 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
      该值是一个长度（像素）。可以通过使用getFloatValue方法获取该值。
      另请参见:

    • CSS_CM

      static final short CSS_CM
      该值是一个长度（厘米）。可以通过使用getFloatValue方法获取该值。
      另请参见:

    • CSS_MM

      static final short CSS_MM
      该值是一个长度（毫米）。可以通过使用getFloatValue方法获取该值。
      另请参见:

    • CSS_IN

      static final short CSS_IN
      该值是一个长度（英寸）。可以通过使用getFloatValue方法获取该值。
      另请参见:

    • CSS_PT

      static final short CSS_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
      该值是一个角度（弧度）。可以通过使用getFloatValue方法获取该值。
      另请参见:

    • CSS_GRAD

      static final short CSS_GRAD
      该值是一个角度（grad）。可以通过使用getFloatValue方法获取该值。
      另请参见:

    • CSS_MS

      static final short CSS_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
      该值是一个字符串。可以通过使用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
      值是矩形函数。可以使用getRectValue方法获取该值。
      参见：

    • CSS_RGBCOLOR

      static final short CSS_RGBCOLOR
      值是RGB颜色。可以使用getRGBColorValue方法获取该值。
      参见：

  • Method Details

    • 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_COUNTER），则引发异常。

    • getRectValue

      Rect getRectValue() throws DOMException
      用于获取矩形值的方法。如果此CSS值不包含矩形值，则会引发DOMException。可以使用Rect接口实现对相应样式属性的修改。
      返回：
      矩形值。
      抛出：
      DOMException - INVALID_ACCESS_ERR：如果CSS值不包含矩形值（例如不是CSS_RECT），则引发异常。

    • getRGBColorValue

      RGBColor getRGBColorValue() throws DOMException
      用于获取RGB颜色的方法。如果此CSS值不包含RGB颜色值，则会引发DOMException。可以使用RGBColor接口实现对相应样式属性的修改。
      返回：
      RGB颜色值。
      抛出：
      DOMException - INVALID_ACCESS_ERR：如果附加属性无法返回RGB颜色值（例如不是CSS_RGBCOLOR），则引发异常。