NAME

CSS - Perl Object oriented access to Cascading Style Sheets (CSS)

SYNOPSIS

use CSS;
...

DESCRIPTION

CSS.pm is able to parse a CSS file, and provide the user with an object oriented interface to the CSS file on 3 levels:

1)the stylesheet as a whole
   my $stylesheet = CSS->new(-source=>"myfile.css");

2)the selector elements and their associated properties
   my @styles = $stylesheet->styles;
   my %properties = $styles[0]->properties;

3)the properties and associated values
   my $value = $properties{'some_property'}

In addition, levels 2) and 3) are able to transform the properties returned by using an Adaptor class (see below). This is useful, for instance, if you need the property 'background-color' to be called just that in your stylesheet, but it should be known as 'BGCOLOR' in another context (an HTML generator, perhaps?).

METHODS

CONSTRUCTOR

Only one constructor: new(). Called with:

-source	required	the source CSS file
-adaptor	optional	used for transforming properties

ACCESSORS

adaptor( scalar )
 read/write.  view/set the adaptor to be used for CSS::Style object 
 creation

add_file(filename or list of filenames) 
  write only.  add selectors from another stylesheet.

purge( scalar )
  write only.  deletes a selector object.

style() or styles()
  read only.  returns a list of CSS::Style objects corresponding to
  the current selectors associated with the CSS object.

AUTHORS

Copyright (C) 2001-2002 Allen Day <allenday@ucla.edu>

Copyright (C) 2003 Cal Henderson <cal@iamcal.com>

SEE ALSO

CSS::Style

CSS::Adaptor

perl(1)