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


Template-Declare documentation Contained in the Template-Declare distribution.

Index


Code Index:

NAME

Top

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

SYNOPSIS

Top

    # 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

Top

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

Top

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
* 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
* 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
* section
* article
* aside
* hgroup
* header
* nav
* figure
* figcaption
* video
* audio
* embed
* mark
* progress
* meter
* time
* ruby
* rt
* rp
* bdi
* wbr
* command
* details
* datalist
* keygen
* output

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, q is mapped to quote, base is mapped to html_base, and time is mapped to datetime. These alternates are to avoid conflicts with the Perl tr and q operators, the time function, 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
* hr
* br
* param
* img
* area
* input
* col

AUTHOR

Top

Agent Zhang <agentzh@yahoo.cn>

SEE ALSO

Top

Template::Declare::TagSet, Template::Declare::TagSet::XUL, Template::Declare::TagSet::RDF, Template::Declare::Tags, Template::Declare.


Template-Declare documentation Contained in the Template-Declare distribution.

package Template::Declare::TagSet::HTML;

use strict;
use warnings;
use base 'Template::Declare::TagSet';
#use Smart::Comments;

our %AlternateSpelling = (
    tr   => 'row',
    td   => 'cell',
    base => 'html_base',
    q    => 'quote',
    time => 'datetime',
);

sub get_alternate_spelling {
    my ($self, $tag) = @_;
    $AlternateSpelling{$tag};
}

# no need to load CGI, really
#sub get_tag_list {
#    my @tags = map { lc($_) } map { @{$_||[]} }
#        @CGI::EXPORT_TAGS{
#                qw/:html2 :html3 :html4 :netscape :form/
#        };
#    return [ @tags, qw/form canvas/ ];
#}

sub get_tag_list {
    return [qw(
        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 section article aside hgroup header footer nav
        figure figcaption video audio embed mark progress meter time ruby rt
        rp bdi wbr command details datalist keygen output
    )]
}

sub can_combine_empty_tags {
    my ($self, $tag) = @_;
    $tag
        =~ m{^ (?: base | meta | link | hr | br | param | img | area | input | col ) $}x;
}

1;
__END__