Changes

Jump to navigation Jump to search
Line 55: Line 55:  
==== make_html_tag_group( NAME[, PARAMS[, TEXT[, LIST]]] ) ====
 
==== make_html_tag_group( NAME[, PARAMS[, TEXT[, LIST]]] ) ====
   −
This method is used internally to do the actual construction of html tag groups.  You can call it directly when you want faster code and/or more control over how tags are made.  The first argument, NAME, is a scalar that defines the actual name of the tag we are making (eg: ’br’); it is case-insensitive.  The optional second argument, PARAMS, is a HASH ref containing attribute names and values for the new tag; the names (keys) are case-insensitive.  Any attribute values which are ARRAY refs are flattened, and the number of tags made is determined by the length of the longest one.  The optional third argument, TEXT, is a HASH ref (or scalar) containing the text that goes between the tag pairs; it is not a tag attribute, but if its an ARRAY ref then its length will influence the number of tags that are made as the length of tag attribute arrays do.  The optional fourth argument, LIST, is a boolean/scalar which indicates whether this method returns the new tags in an ARRAY
+
This method is used internally to do the actual construction of html tag groups.  You can call it directly when you want faster code and/or more control over how tags are made.  The first argument, NAME, is a scalar that defines the actual name of the tag we are making (eg: ’br’); it is case-insensitive.  The optional second argument, PARAMS, is a HASH ref containing attribute names and values for the new tag; the names (keys) are case-insensitive.  Any attribute values which are ARRAY refs are flattened, and the number of tags made is determined by the length of the longest one.  The optional third argument, TEXT, is a HASH ref (or scalar) containing the text that goes between the tag pairs; it is not a tag attribute, but if its an ARRAY ref then its length will influence the number of tags that are made as the length of tag attribute arrays do.  The optional fourth argument, LIST, is a boolean/scalar which indicates whether this method returns the new tags in an ARRAY ref (one tag per element) or as a scalar (tags are concatenated together); a true value forces an ARRAY ref, scalar is the default.  This method knows which HTML tags are normally paired or not, which tag attributes take specified values or not, and acts accordingly.
      ref (one tag per element) or as a scalar (tags are concatenated together); a true value forces an ARRAY ref, scalar is the default.  This method knows which HTML tags are normally paired or not, which tag attributes take specified values or not, and acts accordingly.
+
 
 
=== COMPATABILITY WITH OTHER MODULES ===
 
=== COMPATABILITY WITH OTHER MODULES ===
 
The methods of this class and their parameters are designed to be compatible with any same-named methods in the popular CGI.pm class.  This class will produce identical or browser-compatible HTML from such methods, and this class can accept all the same argument formats.  Exceptions to this include:
 
The methods of this class and their parameters are designed to be compatible with any same-named methods in the popular CGI.pm class.  This class will produce identical or browser-compatible HTML from such methods, and this class can accept all the same argument formats.  Exceptions to this include:

Navigation menu