NAME

Template::Declare::TagSet::HTML - Template::Declare tag set for HTML

SYNOPSIS

    # normal use on the user side:
    use base 'Template::Declare';
    use Template::Declare::Tags 'HTML';

    template foo => sub {
        html {
            body {
            }
        }
    };

    # in Template::Declare::Tags:

    use Template::Declare::TagSet::HTML;
    my $tagset = Template::Declare::TagSet::HTML->new({
        package   => 'MyHTML',
        namespace => 'html',
    });
    my $list = $tagset->get_tag_list();
    print $_, $/ for @{ $list };

    if ( $altern = $tagset->get_alternate_spelling('tr') ) {
        print $altern;
    }

    if ( $tagset->can_combine_empty_tags('img') ) {
        print q{<img src="blah.gif" />};
    }

DESCRIPTION

Template::Declare::TagSet::HTML defines a full set of HTML tags for use in Template::Declare templates. All elements for HTML 2, HTML 3, HTML 4, and XHTML 1 are defined. You generally won't use this module directly, but will load it via:

    use Template::Declare::Tags 'HTML';

METHODS

new( PARAMS )

    my $html_tag_set = Template::Declare::TagSet->new({
        package   => 'MyHTML',
        namespace => 'html',
    });

Constructor inherited from Template::Declare::TagSet.

get_tag_list

    my $list = $tag_set->get_tag_list();

Returns an array ref of all the HTML tags defined by Template::Declare::TagSet::HTML. Here is the complete list:

h1
h2
h3
h4
h5
h6
p
br
hr
ol
ul
li
dl
dt
dd
menu
code
var
strong
em
tt
u
i
b
blockquote
pre
img
a
address
cite
samp
dfn
html
head
base
body
link
nextid
title
meta
kbd
start_html
end_html
input
select
option
comment
charset
escapehtml
div
table
caption
th
td
tr
tr
sup
sub
strike
applet
param
nobr
embed
basefont
style
span
layer
ilayer
font
frameset
frame
script
small
big
area
map
abbr
acronym
bdo
col
colgroup
del
fieldset
iframe
ins
label
legend
noframes
noscript
object
optgroup
q
thead
tbody
tfoot
blink
fontsize
center
textfield
textarea
filefield
password_field
hidden
checkbox
checkbox_group
submit
reset
defaults
radio_group
popup_menu
button
autoescape
scrolling_list
image_button
start_form
end_form
startform
endform
start_multipart_form
end_multipart_form
isindex
tmpfilename
uploadinfo
url_encoded
multipart
form
canvas

get_alternate_spelling( TAG )

    $bool = $obj->get_alternate_spelling($tag);

Returns the alternative spelling for a given tag if any or undef otherwise. Currently, tr is mapped to row, td is mapped to cell, and base is mapped to html_base. These alternates are to avoid conflicts with the Perl operator tr and the base module, with td changed so as to keep consistent with table rows.

can_combine_empty_tags( TAG )

    $bool = $obj->can_combine_empty_tags($tag);

Specifies whether <tag></tag> can be combined into a single token, <tag />. Currently, only a few HTML tags are allowed to be combined:

base
meta
link
hr
br
param
img
area
input
col

AUTHOR

Agent Zhang <agentzh@yahoo.cn>

CPAN RT