- All Superinterfaces:
- CSSValue
The 
CSSPrimitiveValue interface represents a single CSS value
 . This interface may be used to determine the value of a specific style
 property currently set in a block or to set a specific style property
 explicitly within the block. An instance of this interface might be
 obtained from the getPropertyCSSValue method of the
 CSSStyleDeclaration interface. A
 CSSPrimitiveValue object only occurs in a context of a CSS
 property.
  Conversions are allowed between absolute values (from millimeters to
 centimeters, from degrees to radians, and so on) but not between relative
 values. (For example, a pixel value cannot be converted to a centimeter
 value.) Percentage values can't be converted since they are relative to
 the parent value (or another property value). There is one exception for
 color percentage values: since a color percentage value is relative to
 the range 0-255, a color percentage value can be converted to a number;
 (see also the RGBColor interface).
 
See also the Document Object Model (DOM) Level 2 Style Specification.
- Since:
- 1.4, DOM Level 2
- 
Field SummaryFieldsModifier and TypeFieldDescriptionstatic final shortThe value is a attribute function.static final shortThe value is a length (cm).static final shortThe value is a counter or counters function.static final shortThe value is an angle (deg).static final shortThe value is a number with an unknown dimension.static final shortThe value is a length (ems).static final shortThe value is a length (exs).static final shortThe value is an angle (grad).static final shortThe value is a frequency (Hz).static final shortThe value is an identifier.static final shortThe value is a length (in).static final shortThe value is a frequency (kHz).static final shortThe value is a length (mm).static final shortThe value is a time (ms).static final shortThe value is a simple number.static final shortThe value is a length (pc).static final shortThe value is a percentage.static final shortThe value is a length (pt).static final shortThe value is a length (px).static final shortThe value is an angle (rad).static final shortThe value is a rect function.static final shortThe value is a RGB color.static final shortThe value is a time (s).static final shortThe value is a STRING.static final shortThe value is not a recognized CSS2 value.static final shortThe value is a URI.Fields declared in interface org.w3c.dom.css.CSSValueCSS_CUSTOM, CSS_INHERIT, CSS_PRIMITIVE_VALUE, CSS_VALUE_LIST
- 
Method SummaryModifier and TypeMethodDescriptionThis method is used to get the Counter value.floatgetFloatValue(short unitType) This method is used to get a float value in a specified unit.shortThe type of the value as defined by the constants specified above.This method is used to get the Rect value.This method is used to get the RGB color.This method is used to get the string value.voidsetFloatValue(short unitType, float floatValue) A method to set the float value with a specified unit.voidsetStringValue(short stringType, String stringValue) A method to set the string value with the specified unit.Methods declared in interface org.w3c.dom.css.CSSValuegetCssText, getCssValueType, setCssText
- 
Field Details- 
CSS_UNKNOWNstatic final short CSS_UNKNOWNThe value is not a recognized CSS2 value. The value can only be obtained by using thecssTextattribute.- See Also:
 
- 
CSS_NUMBERstatic final short CSS_NUMBERThe value is a simple number. The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_PERCENTAGEstatic final short CSS_PERCENTAGEThe value is a percentage. The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_EMSstatic final short CSS_EMSThe value is a length (ems). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_EXSstatic final short CSS_EXSThe value is a length (exs). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_PXstatic final short CSS_PXThe value is a length (px). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_CMstatic final short CSS_CMThe value is a length (cm). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_MMstatic final short CSS_MMThe value is a length (mm). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_INstatic final short CSS_INThe value is a length (in). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_PTstatic final short CSS_PTThe value is a length (pt). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_PCstatic final short CSS_PCThe value is a length (pc). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_DEGstatic final short CSS_DEGThe value is an angle (deg). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_RADstatic final short CSS_RADThe value is an angle (rad). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_GRADstatic final short CSS_GRADThe value is an angle (grad). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_MSstatic final short CSS_MSThe value is a time (ms). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_Sstatic final short CSS_SThe value is a time (s). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_HZstatic final short CSS_HZThe value is a frequency (Hz). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_KHZstatic final short CSS_KHZThe value is a frequency (kHz). The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_DIMENSIONstatic final short CSS_DIMENSIONThe value is a number with an unknown dimension. The value can be obtained by using thegetFloatValuemethod.- See Also:
 
- 
CSS_STRINGstatic final short CSS_STRINGThe value is a STRING. The value can be obtained by using thegetStringValuemethod.- See Also:
 
- 
CSS_URIstatic final short CSS_URIThe value is a URI. The value can be obtained by using thegetStringValuemethod.- See Also:
 
- 
CSS_IDENTstatic final short CSS_IDENTThe value is an identifier. The value can be obtained by using thegetStringValuemethod.- See Also:
 
- 
CSS_ATTRstatic final short CSS_ATTRThe value is a attribute function. The value can be obtained by using thegetStringValuemethod.- See Also:
 
- 
CSS_COUNTERstatic final short CSS_COUNTERThe value is a counter or counters function. The value can be obtained by using thegetCounterValuemethod.- See Also:
 
- 
CSS_RECTstatic final short CSS_RECTThe value is a rect function. The value can be obtained by using thegetRectValuemethod.- See Also:
 
- 
CSS_RGBCOLORstatic final short CSS_RGBCOLORThe value is a RGB color. The value can be obtained by using thegetRGBColorValuemethod.- See Also:
 
 
- 
- 
Method Details- 
getPrimitiveTypeshort getPrimitiveType()The type of the value as defined by the constants specified above.
- 
setFloatValueA method to set the float value with a specified unit. If the property attached with this value can not accept the specified unit or the float value, the value will be unchanged and aDOMExceptionwill be raised.- Parameters:
- unitType- A unit code as defined above. The unit code can only be a float unit type (i.e.- 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- The new float value.
- Throws:
- DOMException- INVALID_ACCESS_ERR: Raised if the attached property doesn't support the float value or the unit type.
 NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.
 
- 
getFloatValueThis method is used to get a float value in a specified unit. If this CSS value doesn't contain a float value or can't be converted into the specified unit, aDOMExceptionis raised.- Parameters:
- unitType- A unit code to get the float value. The unit code can only be a float unit type (i.e.- 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).
- Returns:
- The float value in the specified unit.
- Throws:
- DOMException- INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a float value or if the float value can't be converted into the specified unit.
 
- 
setStringValueA method to set the string value with the specified unit. If the property attached to this value can't accept the specified unit or the string value, the value will be unchanged and aDOMExceptionwill be raised.- Parameters:
- stringType- A string code as defined above. The string code can only be a string unit type (i.e.- CSS_STRING,- CSS_URI,- CSS_IDENT, and- CSS_ATTR).
- stringValue- The new string value.
- Throws:
- DOMException- INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a string value or if the string value can't be converted into the specified unit.
 NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.
 
- 
getStringValueThis method is used to get the string value. If the CSS value doesn't contain a string value, aDOMExceptionis raised. Some properties (like 'font-family' or 'voice-family') convert a whitespace separated list of idents to a string.- Returns:
- The string value in the current unit. The current
   primitiveTypecan only be a string unit type (i.e.CSS_STRING,CSS_URI,CSS_IDENTandCSS_ATTR).
- Throws:
- DOMException- INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a string value.
 
- 
getCounterValueThis method is used to get the Counter value. If this CSS value doesn't contain a counter value, aDOMExceptionis raised. Modification to the corresponding style property can be achieved using theCounterinterface.- Returns:
- The Counter value.
- Throws:
- DOMException- INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a Counter value (e.g. this is not- CSS_COUNTER).
 
- 
getRectValueThis method is used to get the Rect value. If this CSS value doesn't contain a rect value, aDOMExceptionis raised. Modification to the corresponding style property can be achieved using theRectinterface.- Returns:
- The Rect value.
- Throws:
- DOMException- INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a Rect value. (e.g. this is not- CSS_RECT).
 
- 
getRGBColorValueThis method is used to get the RGB color. If this CSS value doesn't contain a RGB color value, aDOMExceptionis raised. Modification to the corresponding style property can be achieved using theRGBColorinterface.- Returns:
- the RGB color value.
- Throws:
- DOMException- INVALID_ACCESS_ERR: Raised if the attached property can't return a RGB color value (e.g. this is not- CSS_RGBCOLOR).
 
 
-