Module  jdk.xml.dom
软件包  org.w3c.dom.css

Interface CSSPrimitiveValue

  • All Superinterfaces:
    CSSValue


    public interface CSSPrimitiveValue
    extends CSSValue
    CSSPrimitiveValue接口表示单个CSS值。 此接口可用于确定块中当前设置的特定样式属性的值或在块中显式设置特定样式属性。 可以从CSSStyleDeclaration接口的getPropertyCSSValue方法获取此接口的实例。 一个CSSPrimitiveValue对象只发生在CSS属性的上下文中。

    允许绝对值(从毫米到厘米,从度数到弧度等)之间进行转换,但不允许在相对值之间进行转换。 (例如,像素值不能转换为厘米值。)百分比值不能转换,因为它们相对于父值(或另一个属性值)。 颜色百分比值有一个例外:由于颜色百分比值相对于范围0-255,颜色百分比值可以转换为数字; (另见RGBColor界面)。

    另见Document Object Model (DOM) Level 2 Style Specification

    从以下版本开始:
    1.4,DOM Level 2
    • 字段详细信息

      • 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_NUMBERCSS_PERCENTAGECSS_EMSCSS_EXSCSS_PXCSS_CMCSS_MMCSS_INCSS_PTCSS_PCCSS_DEGCSS_RADCSS_GRADCSS_MSCSS_SCSS_HZCSS_KHZCSS_DIMENSION )。
        floatValue - 新的浮点值。
        异常
        DOMException - INVALID_ACCESS_ERR:如果附加属性不支持浮点值或单位类型,则DOMException
        NO_MODIFICATION_ALLOWED_ERR:如果此属性是只读的,则引发。
      • getFloatValue

        float getFloatValue​(short unitType)
                     throws DOMException
        此方法用于获取指定单位中的浮点值。 如果此CSS值不包含浮点值或无法转换为指定单位, DOMException引发DOMException
        参数
        unitType - 获取浮点值的单位代码。 单元代码只能是浮动单元类型(即CSS_NUMBERCSS_PERCENTAGECSS_EMSCSS_EXSCSS_PXCSS_CMCSS_MMCSS_INCSS_PTCSS_PCCSS_DEGCSS_RADCSS_GRADCSS_MSCSS_SCSS_HZCSS_KHZCSS_DIMENSION )。
        结果
        指定单位的浮点值。
        异常
        DOMException - INVALID_ACCESS_ERR:如果CSS值不包含浮点值或浮点值无法转换为指定单位,则 DOMException
      • setStringValue

        void setStringValue​(short stringType,
                            String stringValue)
                     throws DOMException
        用指定单位设置字符串值的方法。 如果附加到该值的属性不能接受指定的单位或字符串值,则该值将保持不变,并提供DOMException
        参数
        stringType - 如上定义的字符串代码。 的字符串的代码只能是一个字符串单元类型(即CSS_STRINGCSS_URICSS_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_STRINGCSS_URICSS_IDENTCSS_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