NAME¶

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

SYNOPSIS¶

  use CSS;
  # create a CSS object with the default options  
  my $css = CSS->new();
  # create a CSS object with a specific parser
  my $css = CSS->new( { 'parser' => 'CSS::Parse::Lite' } );
  my $css = CSS->new( { 'parser' => 'CSS::Parse::Heavy' } );
  my $css = CSS->new( { 'parser' => 'CSS::Parse::Compiled' } );
  # create a CSS object with a specific adaptor
  my $css = CSS->new( { 'adaptor' => 'CSS::Adaptor' } );
  my $css = CSS->new( { 'adaptor' => 'CSS::Adaptor::Pretty' } );
  my $css = CSS->new( { 'adaptor' => 'CSS::Adaptor::Debug' } );
  # parse some CSS from a string
  $css->read_string( $css_data );
  $css->read_string( ( $css_data, $more_css_data ) );
  # parse some CSS from a file
  $css->read_file( 'my_file.css' );
  $css->read_file( ( 'my_file.css', 'my_other_file.css' ) );
  # output the CSS using the current adaptor
  print $css->output();
  # set a new adaptor and then output the CSS
  $css->set_adaptor( 'CSS::Adaptor::Foo' );
  print $css->output();
  # output the CSS using a tempory adaptor
  print $css->output( 'CSS::Adaptor::Bar' );
  # forget about the CSS we've already parsed
  $css->purge();

DESCRIPTION¶

This module can be used, along with a CSS::Parse::* module, to parse CSS data and represent it as a tree of objects. Using a CSS::Adaptor::* module, the CSS data tree can then be transformed into other formats.

NOTICE¶

From version 1.00 of this module onwards, backwards compatibility is broken. This is due to large changes in the way data is parsed and then represented internally. Version 0.08 is still available on CPAN: <http://search.cpan.org/author/IAMCAL/CSS-0.08/>

TREE STRUCTURE¶

The CSS object is the head of the tree. It contains a list of CSS::Style objects which each represent a CSS ruleset. Each of these objects contains a list of selectors and properties. Each selector is stored as a CSS::Selector object. Each property object is stored as a CSS::Property object and contains a list of values. These values are stored as CSS::Value objects.

  foo, bar {
      baz: fop;
      woo: yay houpla;
  }

The above example would be represented as a single CSS::Style object. That object would then have two CSS::Selector objects representing 'foo' and 'bar'. It would also have two CSS::Property objects representing 'baz' and 'woo'. The 'baz' object then has a single child CSS::Value object for 'fop', whilst the 'woo' object has two child objects for 'yay' and 'houpla'.

METHODS¶

AUTHORS¶

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

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

SEE ALSO¶

CSS::Style, CSS::Selector, CSS::Property, CSS::Value, CSS::Parse, CSS::Parse::Lite, CSS::Parse::Heavy, CSS::Parse::Compiled, CSS::Parse::PRDGrammar, CSS::Adaptor, CSS::Adaptor::Pretty, CSS::Adaptor::Debug, perl(1)