HTML::DOM, version 0.015

HTML::DOM is a Perl implementation of the HTML Document Object Model

This is an alpha release.  So far,  the level-2 core and  HTML  DOM
interfaces have been implemented, and some of the level-2 event and
style sheet interfaces.


RECENT CHANGES

0.015:
• Removed every last reference to CSS::DOM::StyleDecl, which was
  renamed in 0.03.

0.014:
• Fixed the Makefile.PL so it installs properly and doesn’t downgrade
  CSS::DOM after installing 0.03.
• HTML::DOM->createEvent now dies if the arg passed to it is an unsup-
  ported event category.

0.013:
New features:
• HTML::DOM::Interface now indicates which members have UTF-16
  equivalents.
• Changes to conform to the Level-2 HTML DOM module (see the
  Changes file).
• HTML::DOM::Exception now has a ‘code’ method. I don’t know how I
  missed this.
• The brand new shiny default_event_handler_for method has been added.
  It makes it less cumbersome to provide default behaviours for diffe-
  rent event types.
• All HTML elements now have a click method--something from HTML 5 (I
  seem to be getting ahead of myself).
Bug fixes — see the Changes file


TO DO

- Finish Level 2 Events support
- Finish Level 2 CSS support
- Finish DOM Level 0 event support (add event properties)
- Provide support for multiple default event handers, each assigned
  to a different type of event
- innerHTML (and outerHTML?)
- Other DOM interfaces (the rest of level 2, and level 3)
- Support callback routines for creating DOM objects for frames.
- HTML 5 stuff
- Write more complete documentation
- Write more tests


INSTALLATION

The easiest way to install this module is to use the CPAN module or
the cpan script:

    [sudo] perl -MCPAN -e "install HTML::DOM"

    [sudo] cpan HTML::DOM

Or you can use the following:

    perl Makefile.PL
    make
    make test
    [sudo] make install


DEPENDENCIES

This module requires perl 5.8.2 or later and the following
Perl modules:

- Scalar::Util 1.14 or later
- Exporter 5.57 or later
- HTML::TreeBuilder and HTML::Element (both part of the HTML::Tree
  distribution) (tested with 3.23)
- URI (tested with 1.35)
- HTTP::Headers::Util is required for writing cookies.
- HTML::Form 1.054 is required if any of the methods provided for
  WWW::Mechanize compatibility are to be used.
- CSS::DOM 0.03 or later
- HTML::Encoding is required if the parse_file method is to be used.
- constant::lexical


DOCUMENTATION

After installing, you can find documentation for this module with the 
perldoc command.

    perldoc HTML::DOM

Or try using man (it's faster, in my experience):

    man HTML::DOM


COPYRIGHT AND LICENCE

Copyright (C) 2007 Father Chrysostomos

This program is free software; you may redistribute it and/or modify
it under the same terms as perl.
