模块  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属性获取该值。
        另请参见:
        常数字段值
      • 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_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 某些属性(如'font-family'或'voice-family')将以空格分隔的ident列表转换为字符串。
        结果
        当前单位中的字符串值。 当前primitiveType只能是一个字符串单元类型(即CSS_STRINGCSS_URICSS_IDENTCSS_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_COUNTERCSS_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_RGBCOLORCSS_RGBCOLOR