CSS::DOM::Rule(3pm) User Contributed Perl Documentation CSS::DOM::Rule(3pm)NAME
CSS::DOM::Rule - CSS rule class for CSS::DOM
VERSION
Version 0.14
SYNOPSIS
use CSS::DOM::Rule ':all'; # import constants
use CSS::DOM;
$sheet = new CSS::DOM;
$sheet->insertRule('bla blah blah {}');
$rule = $sheet->cssRules->[0];
$rule->type; # STYLE_RULE
$rule->cssText; # 'bla blah blah {}' or similar
$rule->cssText('p { margin: 0 }'); # replace it
$rule->parentStyleSheet; # $sheet
DESCRIPTION
This module provides the CSS rule class for CSS::DOM. It implements the CSSRule and CSSUnknownRule DOM interfaces.
METHODS
Constructor
Only call the constructor on this class to create an 'unknown' rule. You have to call the constructor on a particular subclass to get
another type. Normally you do not need to call this directly anyway. (See CSS::DOM's "parse" and "insertRule" methods.) But just in case
you do want to call it, here it is:
new CSS::DOM::Rule $parent; # unknown rule
require CSS::DOM::Rule::Style
new CSS::DOM::Rule::Style $parent;
# etc.
$parent is the parent rule, if the rule is nested, or the parent style sheet otherwise.
Object Methods
type
Returns one of the constants below indicating the type of rule.
cssText
Returns this rule's CSS code. If you pass an argument, it will be parsed as the new CSS code for this rule (replacing the existing
data), and the old value will be returned. This method will die if the replacement CSS code creates a different type of rule.
parentStyleSheet
This returns the style sheet to which the rule belongs.
parentRule
This returns the rule's parent rule, if there is one, or an empty list otherwise. There is only a parent rule if this one is nested,
e.g., inside a media rule.
EXPORTS
The following constants that indicate the type of rule will be exported on request (individually or with the ':all' tag):
UNKNOWN_RULE
STYLE_RULE
CHARSET_RULE
IMPORT_RULE
MEDIA_RULE
FONT_FACE_RULE
PAGE_RULE
SEE ALSO
CSS::DOM
CSS::DOM::Rule::Style
CSS::DOM::Rule::Media
CSS::DOM::Rule::Page
CSS::DOM::Rule::Import
perl v5.10.1 2010-12-10 CSS::DOM::Rule(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)