Template::Declare::TagSet::HTML.3pm

Langue: en

Autres versions - même langue

Version: 2009-10-16 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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>

SEE ALSO

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