CSS::DOM::Util(3pm) User Contributed Perl Documentation CSS::DOM::Util(3pm)NAME
CSS::DOM::Util - Utility functions for dealing with CSS tokens
VERSION
Version 0.14
SYNOPSIS
use CSS::DOM::Util ':all';
# or:
use CSS::DOM::Util qw[
escape unescape
escape_ident unescape_url
escape_str unescape_str
];
DESCRIPTION
This module provides utility functions for dealing with CSS tokens.
FUNCTIONS
All functions below that take one argument have a "($)" prototype, so they have the same precedence as "closedir" and "delete".
escape $string, $chars_to_escape
This escapes any characters in $string that occur in $chars_to_escape, which is interpreted as a regular expression. The regexp must
consume just one character; otherwise you'll find chars missing from the output. ASCII vertical whitespace (except the vertical tab) is
always escaped.
Printable non-alphanumeric ASCII characters and the space character are escaped with a single backslash. Other characters are encoded
in hexadecimal.
"escape" also considers that you might want to include the escaped string in a larger string, so it appends a space if the escaped
string ends with a hexadecimal escape with fewer than six digits.
unescape $string
This turns something like "H65llo" into "Hello" (including quotes).
escape_ident $string
escape_ident $string, $more_chars_to_escape
This escapes $string as a CSS identifier, escaping also any characters matched by $more_chars_to_escape.
unescape_url $url_token
Returns the URL that the token represents.
escape_str $string
Returns a CSS string token containing $string (within quotes; characters possibly escaped).
unescape_str $string_token
Returns the value that a CSS string token represents.
SEE ALSO
CSS::DOM
perl v5.10.1 2010-12-10 CSS::DOM::Util(3pm)
Check Out this Related Man Page
CSS::DOM::Style(3pm) User Contributed Perl Documentation CSS::DOM::Style(3pm)NAME
CSS::DOM::Style - CSS style declaration class for CSS::DOM
VERSION
Version 0.14
SYNOPSIS
use CSS::DOM::Style;
$style = CSS::DOM::Style::parse(' text-decoration: none ');
$style->cssText; # returns 'text-decoration: none'
$style->cssText('color: blue'); # replace contents
$style->getPropertyValue('color'); # 'blue'
$style->color; # same
$style->setProperty(color=>'green'); # change it
$style->color('green'); # same
DESCRIPTION
This module provides the CSS style declaration class for CSS::DOM. (A style declaration is what comes between the braces in "p { margin: 0
}".) It implements the CSSStyleDeclaration DOM interface.
CONSTRUCTORS
CSS::DOM::Style::parse( $string )
CSS::DOM::Style::parse( $string, property_parser => $parser )
This parses the $string and returns a new style declaration object. This is useful if you have text from an HTML "style" attribute, for
instance.
For details on $property_parser, see CSS::DOM::PropertyParser.
new CSS::DOM::Style $owner_rule
new CSS::DOM::Style owner => $owner_rule, property_parser => $p
You don't normally need to call this, but, in case you do, here it is. $owner_rule, which is optional, is expected to be a
CSS::DOM::Rule object, or a subclass like CSS::DOM::Rule::Style.
METHODS
cssText ( $new_value )
Returns the body of this style declaration (without the braces). If you pass an argument, it will parsed and replace the existing CSS
data.
getPropertyValue ( $name )
Returns the value of the named CSS property as a string.
getPropertyCSSValue ( $name )
Returns an object representing the property's value. (See CSS::DOM::Value.)
removeProperty ( $name )
Removes the named property, returning its value.
getPropertyPriority
Returns the property's priority. This is usually the empty string or the word 'important'.
setProperty ( $name, $value, $priority )
Sets the CSS property named $name, giving it a value of $value and setting the priority to $priority.
length
Returns the number of properties
item ( $index )
Returns the name of the property at the given index.
parentRule
Returns the rule to which this declaration belongs.
modification_handler ( $coderef )
This method, not part of the DOM, allows you to attach a call-back routine that is run whenever a change occurs to the style object
(with the style object as its only argument). If you call it without an argument it returns the current handler. With an argument, it
returns the old value after setting it.
property_parser
This returns the parser that was passed to the constructor.
This module also has methods for accessing each CSS property directly. Simply capitalise each letter in a CSS property name that follows a
hyphen, then remove the hyphens, and you'll have the method name. E.g., call the "borderBottomWidth" method to get/set the border-bottom-
width property. One exception to this is that "cssFloat" is the method used to access the 'float' property. (But you can also use the
"float" method, though it's not part of the DOM standard.)
SEE ALSO
CSS::DOM
CSS::DOM::Rule::Style
CSS::DOM::PropertyParser
HTML::DOM::Element
perl v5.10.1 2010-12-10 CSS::DOM::Style(3pm)