com.itextpdf.html2pdf.css.util

Class CssUtils

java.lang.Object

com.itextpdf.html2pdf.css.util.CssUtils

public class CssUtils
extends Object

Utilities class for CSS operations.

Method Summary

Modifier and Type	Method and Description
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	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	isMetricValue(String value) Checks whether a string contains an allowed metric unit in HTML/CSS; px, in, cm, mm, pc or pt.
static boolean	isNumericValue(String value) Checks whether a string matches a numeric value (e.g.
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 String	normalizeCssProperty(String str) Normalizes a CSS property.
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 int[]	parseAspectRatio(String str) Parses an aspect ratio into an array with two integers.
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 com.itextpdf.layout.property.UnitValue	parseLengthValueToPt(String value, float emValue, float remValue) Parses the length value to pt.
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 String	removeDoubleSpacesAndTrim(String str) Removes double spaces and trims a string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

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

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 com.itextpdf.layout.property.UnitValue parseLengthValueToPt(String value,
                                                                          float emValue,
                                                                          float remValue)

Parses the length value to pt.

Parameters:

value - the value

emValue - the em value

remValue - the root em value

Returns:

the unit value

parseResolution

public static float parseResolution(String resolutionStr)

Parses the resolution.

Parameters:

resolutionStr - the resolution as a string

Returns:

a value in dpi (currently)

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

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

isMetricValue

public static boolean isMetricValue(String value)

Checks whether a string contains an allowed metric unit in HTML/CSS; px, in, cm, mm, pc or pt.

Parameters:

value - the string that needs to be checked.

Returns:

boolean true if value contains an allowed metric 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.

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 an allowed metric 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