CssUtils (iText 7 - Styled XML Parser 7.1.13 API)

java.lang.Object
- com.itextpdf.styledxmlparser.css.util.CssUtils

```
public class CssUtils
extends Object
```
Utilities class for CSS operations.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static boolean`	`compareFloats(double d1, double d2)` Helper method for comparing floating point numbers
`static boolean`	`compareFloats(float f1, float f2)` Helper method for comparing floating point numbers
`static double`	`convertPtsToPx(double pts)` Convert given point value to a pixel value.
`static float`	`convertPtsToPx(float pts)` Convert given point value to a pixel value.
`static double`	`convertPxToPts(double px)` Convert given point value to a point value.
`static float`	`convertPxToPts(float px)` Convert given point value to a point value.
`static int`	`determinePositionBetweenValueAndUnit(String string)` Method used in preparation of splitting a string containing a numeric value with a metric unit (e.g.
`static List<List<String>>`	`extractShorthandProperties(String str)` Extracts shorthand properties as list of string lists from a string, where the top level list is shorthand property and the lower level list is properties included in shorthand property.
`static String`	`extractUrl(String url)` Parses `url("file.jpg")` to `file.jpg`.
`static int`	`findNextUnescapedChar(String source, char ch, int startIndex)` Find the next unescaped character.
`static boolean`	`isAngleValue(String value)` Checks whether a string contains an allowed metric unit in HTML/CSS; rad, deg and grad.
`static boolean`	`isBase64Data(String data)` Checks if a data is base 64 encoded.
`static boolean`	`isColorProperty(String value)` Checks if a value is a color property.
`static boolean`	`isEmValue(String value)` Checks whether a string contains an allowed value relative to parent value.
`static boolean`	`isExValue(String value)` Checks whether a string contains an allowed value relative to element font height.
`static boolean`	`isFontRelativeValue(String value)` Checks whether a string contains an allowed value relative to font.
`static boolean`	`isInitialOrInheritOrUnset(String value)` Checks if value is initial, inherit or unset.
`static boolean`	`isMetricValue(String value)` Checks whether a string contains an allowed metric unit in HTML/CSS; px, in, cm, mm, pc, Q or pt.
`static boolean`	`isNumericValue(String value)` Checks whether a string matches a numeric value (e.g.
`static boolean`	`isPercentageValue(String value)` Checks whether a string contains a percentage value
`static boolean`	`isRelativeValue(String value)` Checks whether a string contains an allowed value relative to previously set value.
`static boolean`	`isRemValue(String value)` Checks whether a string contains an allowed value relative to previously set root value.
`static boolean`	`isStyleSheetLink(IElementNode headChildElement)` Checks if an `IElementNode` represents a style sheet link.
`static boolean`	`isValidNumericValue(String value)` Checks if a string is in a valid format.
`static String`	`normalizeCssProperty(String str)` Normalizes a CSS property.
`static float`	`parseAbsoluteFontSize(String fontSizeValue)` Parses the absolute font size.
`static float`	`parseAbsoluteFontSize(String fontSizeValue, String defaultMetric)` Parses the absolute font size.
`static float`	`parseAbsoluteLength(String length)` Parses the absolute length.
`static float`	`parseAbsoluteLength(String length, String defaultMetric)` Parses a length with an allowed metric unit (px, pt, in, cm, mm, pc, q) or numeric value (e.g.
`static float`	`parseAngle(String angle)` Parses a angle with an allowed metric unit (deg, grad, rad) or numeric value (e.g.
`static float`	`parseAngle(String angle, String defaultMetric)` Parses an angle with an allowed metric unit (deg, grad, rad) or numeric value (e.g.
`static int[]`	`parseAspectRatio(String str)` Parses an aspect ratio into an array with two integers.
`static BlendMode`	`parseBlendMode(String cssValue)` Parses the given css blend mode value.
`static Double`	`parseDouble(String str)` Parses a double without throwing an exception if something goes wrong.
`static Float`	`parseFloat(String str)` Parses a float without throwing an exception if something goes wrong.
`static Integer`	`parseInteger(String str)` Parses an integer without throwing an exception if something goes wrong.
`static UnitValue`	`parseLengthValueToPt(String value, float emValue, float remValue)` Convenience method for parsing a value to pt.
`static float`	`parseRelativeFontSize(String relativeFontSizeValue, float baseValue)` Parses the relative font size.
`static float`	`parseRelativeValue(String relativeValue, float baseValue)` Parses an relative value based on the base value that was given, in the metric unit of the base value. (e.g.
`static float`	`parseResolution(String resolutionStr)` Parses the resolution.
`static float[]`	`parseRgbaColor(String colorValue)` Parses the RGBA color.
`static UnitValue[]`	`parseSpecificCornerBorderRadius(String specificBorderRadius, float emValue, float remValue)` Parses the border radius of specific corner.
`static Range`	`parseUnicodeRange(String unicodeRange)` Parses the unicode range.
`static String`	`removeDoubleSpacesAndTrim(String str)` Removes double spaces and trims a string.
`static List<String>`	`splitStringWithComma(String value)` Splits the provided `String` by comma with respect of brackets.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - splitStringWithComma
```
public static List<String> splitStringWithComma(String value)
```
    Splits the provided String by comma with respect of brackets.
    
    Parameters:
    
    value - to split
    
    Returns:
    
    the List of split result
  - parseBlendMode
```
public static BlendMode parseBlendMode(String cssValue)
```
    Parses the given css blend mode value. If the argument is null or an unknown blend mode, then the default css BlendMode.NORMAL value would be returned.
    
    Parameters:
    
    cssValue - the value to parse
    
    Returns:
    
    the BlendMode instance representing the parsed value
  - extractShorthandProperties
```
public static List<List<String>> extractShorthandProperties(String str)
```
    Extracts shorthand properties as list of string lists from a string, where the top level list is shorthand property and the lower level list is properties included in shorthand property.
    
    Parameters:
    
    str - the source string with shorthand properties
    
    Returns:
    
    the list of string lists
  - normalizeCssProperty
```
public static String normalizeCssProperty(String str)
```
    Normalizes a CSS property.
    
    Parameters:
    
    str - the property
    
    Returns:
    
    the normalized property
  - removeDoubleSpacesAndTrim
```
public static String removeDoubleSpacesAndTrim(String str)
```
    Removes double spaces and trims a string.
    
    Parameters:
    
    str - the string
    
    Returns:
    
    the string without the unnecessary spaces
  - parseInteger
```
public static Integer parseInteger(String str)
```
    Parses an integer without throwing an exception if something goes wrong.
    
    Parameters:
    
    str - a string that might be an integer value
    
    Returns:
    
    the integer value, or null if something went wrong
  - parseFloat
```
public static Float parseFloat(String str)
```
    Parses a float without throwing an exception if something goes wrong.
    
    Parameters:
    
    str - a string that might be a float value
    
    Returns:
    
    the float value, or null if something went wrong
  - parseDouble
```
public static Double parseDouble(String str)
```
    Parses a double without throwing an exception if something goes wrong.
    
    Parameters:
    
    str - a string that might be a double value
    
    Returns:
    
    the double value, or null if something went wrong
  - parseAngle
```
public static float parseAngle(String angle,
                               String defaultMetric)
```
    Parses an angle with an allowed metric unit (deg, grad, rad) or numeric value (e.g. 123, 1.23, .123) to rad.
    
    Parameters:
    
    angle - String containing the angle to parse
    
    defaultMetric - default metric to use in case the input string does not specify a metric
    
    Returns:
    
    the angle in radians
  - parseAngle
```
public static float parseAngle(String angle)
```
    Parses a angle with an allowed metric unit (deg, grad, rad) or numeric value (e.g. 123, 1.23, .123) to rad. Default metric is degrees
    
    Parameters:
    
    angle - String containing the angle to parse
    
    Returns:
    
    the angle in radians
  - parseAspectRatio
```
public static int[] parseAspectRatio(String str)
```
    Parses an aspect ratio into an array with two integers.
    
    Parameters:
    
    str - a string that might contain two integer values
    
    Returns:
    
    the aspect ratio as an array of two integer values
  - parseAbsoluteLength
```
public static float parseAbsoluteLength(String length,
                                        String defaultMetric)
```
    Parses a length with an allowed metric unit (px, pt, in, cm, mm, pc, q) or numeric value (e.g. 123, 1.23, .123) to pt.
    A numeric value (without px, pt, etc in the given length string) is considered to be in the default metric that was given.
    
    Parameters:
    
    length - the string containing the length.
    
    defaultMetric - the string containing the metric if it is possible that the length string does not contain one. If null the length is considered to be in px as is default in HTML/CSS.
    
    Returns:
    
    parsed value
  - parseAbsoluteLength
```
public static float parseAbsoluteLength(String length)
```
    Parses the absolute length.
    
    Parameters:
    
    length - the length as a string
    
    Returns:
    
    the length as a float
  - parseRelativeValue
```
public static float parseRelativeValue(String relativeValue,
                                       float baseValue)
```
    Parses an relative value based on the base value that was given, in the metric unit of the base value.
    (e.g. margin=10% should be based on the page width, so if an A4 is used, the margin = 0.10*595.0 = 59.5f)
    
    Parameters:
    
    relativeValue - in %, em or ex.
    
    baseValue - the value the returned float is based on.
    
    Returns:
    
    the parsed float in the metric unit of the base value.
  - parseLengthValueToPt
```
public static UnitValue parseLengthValueToPt(String value,
                                             float emValue,
                                             float remValue)
```
    Convenience method for parsing a value to pt. Possible values are:
    - a numeric value in pixels (e.g. 123, 1.23, .123),
    - a value with a metric unit (px, in, cm, mm, pc or pt) attached to it,
    - or a value with a relative value (%, em, ex).
    Parameters:
    
    value - the value
    
    emValue - the em value
    
    remValue - the root em value
    
    Returns:
    
    the unit value
  - isValidNumericValue
```
public static boolean isValidNumericValue(String value)
```
    Checks if a string is in a valid format.
    
    Parameters:
    
    value - the string that needs to be checked.
    
    Returns:
    
    boolean true if value is in a valid format.
  - parseAbsoluteFontSize
```
public static float parseAbsoluteFontSize(String fontSizeValue,
                                          String defaultMetric)
```
    Parses the absolute font size.
    A numeric value (without px, pt, etc in the given length string) is considered to be in the default metric that was given.
    
    Parameters:
    
    fontSizeValue - the font size value as a String
    
    defaultMetric - the string containing the metric if it is possible that the length string does not contain one. If null the length is considered to be in px as is default in HTML/CSS.
    
    Returns:
    
    the font size value as a float
  - parseAbsoluteFontSize
```
public static float parseAbsoluteFontSize(String fontSizeValue)
```
    Parses the absolute font size.
    A numeric value (without px, pt, etc in the given length string) is considered to be in the px.
    
    Parameters:
    
    fontSizeValue - the font size value as a String
    
    Returns:
    
    the font size value as a float
  - parseRelativeFontSize
```
public static float parseRelativeFontSize(String relativeFontSizeValue,
                                          float baseValue)
```
    Parses the relative font size.
    
    Parameters:
    
    relativeFontSizeValue - the relative font size value as a String
    
    baseValue - the base value
    
    Returns:
    
    the relative font size value as a float
  - parseSpecificCornerBorderRadius
```
public static UnitValue[] parseSpecificCornerBorderRadius(String specificBorderRadius,
                                                          float emValue,
                                                          float remValue)
```
    Parses the border radius of specific corner.
    
    Parameters:
    
    specificBorderRadius - string that defines the border radius of specific corner.
    
    emValue - the em value
    
    remValue - the root em value
    
    Returns:
    
    an array of UnitValues that define horizontal and vertical border radius values
  - parseResolution
```
public static float parseResolution(String resolutionStr)
```
    Parses the resolution.
    
    Parameters:
    
    resolutionStr - the resolution as a string
    
    Returns:
    
    a value in dpi
  - determinePositionBetweenValueAndUnit
```
public static int determinePositionBetweenValueAndUnit(String string)
```
    Method used in preparation of splitting a string containing a numeric value with a metric unit (e.g. 18px, 9pt, 6cm, etc).
    
    Determines the position between digits and affiliated characters ('+','-','0-9' and '.') and all other characters.
    e.g. string "16px" will return 2, string "0.5em" will return 3 and string '-8.5mm' will return 4.
    
    Parameters:
    
    string - containing a numeric value with a metric unit
    
    Returns:
    
    int position between the numeric value and unit or 0 if string is null or string started with a non-numeric value.
  - isMetricValue
```
public static boolean isMetricValue(String value)
```
    Checks whether a string contains an allowed metric unit in HTML/CSS; px, in, cm, mm, pc, Q or pt.
    
    Parameters:
    
    value - the string that needs to be checked.
    
    Returns:
    
    boolean true if value contains an allowed metric value.
  - isAngleValue
```
public static boolean isAngleValue(String value)
```
    Checks whether a string contains an allowed metric unit in HTML/CSS; rad, deg and grad.
    
    Parameters:
    
    value - the string that needs to be checked.
    
    Returns:
    
    boolean true if value contains an allowed angle value.
  - isRelativeValue
```
public static boolean isRelativeValue(String value)
```
    Checks whether a string contains an allowed value relative to previously set value.
    
    Parameters:
    
    value - the string that needs to be checked.
    
    Returns:
    
    boolean true if value contains an allowed metric value.
  - isFontRelativeValue
```
public static boolean isFontRelativeValue(String value)
```
    Checks whether a string contains an allowed value relative to font.
    
    Parameters:
    
    value - the string that needs to be checked.
    
    Returns:
    
    boolean true if value contains an allowed font relative value.
  - isPercentageValue
```
public static boolean isPercentageValue(String value)
```
    Checks whether a string contains a percentage value
    
    Parameters:
    
    value - the string that needs to be checked
    
    Returns:
    
    boolean true if value contains an allowed percentage value
  - isRemValue
```
public static boolean isRemValue(String value)
```
    Checks whether a string contains an allowed value relative to previously set root value.
    
    Parameters:
    
    value - the string that needs to be checked.
    
    Returns:
    
    boolean true if value contains a rem value.
  - isEmValue
```
public static boolean isEmValue(String value)
```
    Checks whether a string contains an allowed value relative to parent value.
    
    Parameters:
    
    value - the string that needs to be checked.
    
    Returns:
    
    boolean true if value contains a em value.
  - isExValue
```
public static boolean isExValue(String value)
```
    Checks whether a string contains an allowed value relative to element font height.
    
    Parameters:
    
    value - the string that needs to be checked.
    
    Returns:
    
    boolean true if value contains a ex value.
  - isNumericValue
```
public static boolean isNumericValue(String value)
```
    Checks whether a string matches a numeric value (e.g. 123, 1.23, .123). All these metric values are allowed in HTML/CSS.
    
    Parameters:
    
    value - the string that needs to be checked.
    
    Returns:
    
    boolean true if value contains an allowed metric value.
  - extractUrl
```
public static String extractUrl(String url)
```
    Parses url("file.jpg") to file.jpg.
    
    Parameters:
    
    url - the url attribute to parse
    
    Returns:
    
    the parsed url. Or original url if not wrappend in url()
  - isBase64Data
```
public static boolean isBase64Data(String data)
```
    Checks if a data is base 64 encoded.
    
    Parameters:
    
    data - the data
    
    Returns:
    
    true, if the data is base 64 encoded
  - findNextUnescapedChar
```
public static int findNextUnescapedChar(String source,
                                        char ch,
                                        int startIndex)
```
    Find the next unescaped character.
    
    Parameters:
    
    source - a source
    
    ch - the character to look for
    
    startIndex - where to start looking
    
    Returns:
    
    the position of the next unescaped character
  - isColorProperty
```
public static boolean isColorProperty(String value)
```
    Checks if a value is a color property.
    
    Parameters:
    
    value - the value
    
    Returns:
    
    true, if the value contains a color property
  - compareFloats
```
public static boolean compareFloats(double d1,
                                    double d2)
```
    Helper method for comparing floating point numbers
    
    Parameters:
    
    d1 - first float to compare
    
    d2 - second float to compare
    
    Returns:
    
    True if both floats are equal within a Epsilon defined in this class, false otherwise
  - compareFloats
```
public static boolean compareFloats(float f1,
                                    float f2)
```
    Helper method for comparing floating point numbers
    
    Parameters:
    
    f1 - first float to compare
    
    f2 - second float to compare
    
    Returns:
    
    True if both floats are equal within a Epsilon defined in this class, false otherwise
  - parseRgbaColor
```
public static float[] parseRgbaColor(String colorValue)
```
    Parses the RGBA color.
    
    Parameters:
    
    colorValue - the color value
    
    Returns:
    
    an RGBA value expressed as an array with four float values
  - parseUnicodeRange
```
public static Range parseUnicodeRange(String unicodeRange)
```
    Parses the unicode range.
    
    Parameters:
    
    unicodeRange - the string which stores the unicode range
    
    Returns:
    
    the unicode range as a Range object
  - convertPtsToPx
```
public static float convertPtsToPx(float pts)
```
    Convert given point value to a pixel value. 1 px is 0.75 pts.
    
    Parameters:
    
    pts - float value to be converted to pixels
    
    Returns:
    
    float converted value pts/0.75f
  - convertPtsToPx
```
public static double convertPtsToPx(double pts)
```
    Convert given point value to a pixel value. 1 px is 0.75 pts.
    
    Parameters:
    
    pts - double value to be converted to pixels
    
    Returns:
    
    double converted value pts/0.75
  - convertPxToPts
```
public static float convertPxToPts(float px)
```
    Convert given point value to a point value. 1 px is 0.75 pts.
    
    Parameters:
    
    px - float value to be converted to pixels
    
    Returns:
    
    float converted value px*0.75
  - convertPxToPts
```
public static double convertPxToPts(double px)
```
    Convert given point value to a point value. 1 px is 0.75 pts.
    
    Parameters:
    
    px - double value to be converted to pixels
    
    Returns:
    
    double converted value px*0.75
  - isStyleSheetLink
```
public static boolean isStyleSheetLink(IElementNode headChildElement)
```
    Checks if an IElementNode represents a style sheet link.
    
    Parameters:
    
    headChildElement - the head child element
    
    Returns:
    
    true, if the element node represents a style sheet link
  - isInitialOrInheritOrUnset
```
public static boolean isInitialOrInheritOrUnset(String value)
```
    Checks if value is initial, inherit or unset.
    
    Parameters:
    
    value - value to check.
    
    Returns:
    
    true if value is initial, inherit or unset. false otherwise.

Class CssUtils

Method Summary

Methods inherited from class java.lang.Object

Method Detail

splitStringWithComma

parseBlendMode

extractShorthandProperties

normalizeCssProperty

removeDoubleSpacesAndTrim

parseInteger

parseFloat

parseDouble

parseAngle

parseAngle

parseAspectRatio

parseAbsoluteLength

parseAbsoluteLength

parseRelativeValue

parseLengthValueToPt

isValidNumericValue

parseAbsoluteFontSize

parseAbsoluteFontSize

parseRelativeFontSize

parseSpecificCornerBorderRadius

parseResolution

determinePositionBetweenValueAndUnit

isMetricValue

isAngleValue

isRelativeValue

isFontRelativeValue

isPercentageValue

isRemValue

isEmValue

isExValue

isNumericValue

extractUrl

isBase64Data

findNextUnescapedChar

isColorProperty

compareFloats

compareFloats

parseRgbaColor

parseUnicodeRange

convertPtsToPx

convertPtsToPx

convertPxToPts

convertPxToPts

isStyleSheetLink

isInitialOrInheritOrUnset