File: Document.pm

package info (click to toggle)
libhtml-html5-builder-perl 0.004-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 320 kB
  • sloc: perl: 3,427; makefile: 2
file content (83 lines) | stat: -rw-r--r-- 1,771 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
package HTML::HTML5::Builder::Document;

use HTML::HTML5::Writer 0.104 qw();
use XML::LibXML 1.60 qw();

use 5.008;
use base qw[XML::LibXML::Document];
use common::sense;
use overload '""' => \&toStringHTML;
use utf8;

BEGIN {
	$HTML::HTML5::Builder::Document::AUTHORITY = 'cpan:TOBYINK';
}
BEGIN {
	$HTML::HTML5::Builder::Document::VERSION   = '0.004';
}

sub new
{
	my ($class, @x) = @_;
	bless $class->SUPER::new(@x), $class;
}

sub toStringHTML
{
	my ($self, @x) = @_;
	return HTML::HTML5::Writer->new(@x)->document($self);
}

*serialize_html = \&toStringHTML;

1;

__END__

=head1 NAME

HTML::HTML5::Builder::Document - pretty trivial subclass of XML::LibXML::Document

=head1 DESCRIPTION

C<< HTML::HTML5::Builder::html() >> returns an C<HTML::HTML5::Builder::Document>
object. This inherits from C<XML::LibXML::Document>, but overloads stringification
using C<HTML::HTML5::Writer>.

A non-exhaustive list of interesting methods provided by C<HTML::HTML5::Builder::Document>
objects:

=over

=item C<toString> - outputs XML

=item C<toStringHTML> - outputs HTML

=item C<documentElement> - returns the root element as an C<XML::LibXML::Element>

=item C<findnodes> - search using XPath

=back

=head1 SEE ALSO

L<HTML::HTML5::Builder>,
L<XML::LibXML::Document>.

=head1 AUTHOR

Toby Inkster E<lt>tobyink@cpan.orgE<gt>.

=head1 COPYRIGHT AND LICENCE

This software is copyright (c) 2011 by Toby Inkster.

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.

=head1 DISCLAIMER OF WARRANTIES

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.