* @package phpHtmlLib
*
*/
/**
* Get all the required files for this class
*/
require_once(PHPHTMLLIB_ABSPATH . "/HTMLTagClass.inc");
/**
* class the constructs and renders an entire
* HTML/XHTML document.
*
* @author Walter A. Boring IV
* @package phpHtmlLib
*/
class HTMLPageClass {
/**
* HEADtag object that holds all content
* for the head.
* @var object
* @access private
*/
var $_head = NULL;
/**
* TITLEtag object that holds the title
* of the page.
* @var object
* @access private
*/
var $_title = NULL;
/**
* SCRIPTtag object that holds javascript
* code for the head tag.
* @var object
* @access private
*/
var $_head_js = NULL;
/**
* STYLEtag object that holds css code
* for the head.
* @var object
* @access private
*/
var $_head_style = NULL;
/**
* character set to be used in this
* page. This gets automatically
* placed in the Content-Type
* META tag.
* @var string
* @access private
*/
var $_charset = "iso-8859-1";
/**
* The encoding of the XHTML
* XML tag
*/
var $_xml_encoding = "UTF-8";
/**
* BODYtag object that holds all content
* for the body tag.
* @var object
* @access private
*/
var $_body = NULL;
/**
* DOCTYPEag object that sets the document
* type. This gets rendered prior to
* @var object
* @access private
*/
var $_doctype = NULL;
/**
* flag to tell the class to try and
* change the http headers to output
* document of type text, instead of
* html. This is helpfull for debugging.
* @var boolean
* @access private
*/
var $_text_debug = FALSE;
/**
* This holds a FRAMESETtag object.
* This is used if the person is trying
* to render a frameset page.
*
* @var FRAMESETtag object.
* @access private
*/
var $_frameset = NULL;
/**
* This holds the text used to display
* a body content when a browser doesn't
* support framesets
*
* @var string
* @access private
*/
var $_noframes_text = "Sorry, your browser does not support frames";
/**
* This holds the attributes for the
* tag.
*
* @var array
*/
var $_html_attributes = array();
/**
* keeps track of which widgets we have
* automatically pulled in css for
*
* @var array
*/
var $_widget_css_auto = array();
/**
* keeps track of which widgets we have
* automatically pulled in js for
*
* @var array
*/
var $_widget_js_auto = array();
/**
* Holds the value of the indent
* style the user wants to render
* the page w/
*
* @var int
*/
var $_indent_style = 0;
/**
* keeps track of the html
* render type.
*
* @var string
*/
var $_html_render_type = HTML;
/**
* The favicon params
* @var array
*/
var $_favicon = array("href" => "/favicon.ico",
"type" => "images/x-ico",
"enabled" => FALSE);
/**
* Class Constructor
* @param mixed - $title Title string or TITLEtag object for the page.
* @param string - one of 3 types of html to render. Setting this will
* make the object declare the gobal define which tells
* all of the tag objects what type of html tags to render.
* some tags support special features. such as the ![]()
* tag. If xhtml is selected, the the IMGtag object and all
* utility functions will not render "border=0" as a default
* attribute, since this is not proper xhtml.
* "html" - HTML 4.0 (default)
* "xhtml_transitional" - render xhtml instead of html
* - doctype is XHTML transitional.
* "xhtml_strict" - render xhtml instead of html 4.0.
* - doctype is XHTML strict.
* @param int - one of 2 types. INDENT_NICE or INDENT_LEFT_JUSTIFY
* This tells the page how to render the indenting of the
* output. By default it is set to INDENT_NICE, which nicely
* indents each nested tag. You can have all tags rendered
* left justified (smaller size in output) by using
* INDENT_LEFT_JUSTIFY
*
* @access public
*/
function HTMLPageClass($title=NULL, $html_type=HTML, $indent_style=INDENT_NICE) {
switch ($html_type) {
case HTML:
default:
$this->build_doctype("-//W3C//DTD HTML 4.01 Transitional//EN",
"http://www.w3.org/TR/html4/loose.dtd");
$this->_html_render_type = $GLOBALS["HTML_RENDER_TYPE"] = HTML;
break;
case XHTML_STRICT:
$this->build_doctype("-//W3C//DTD XHTML 1.0 Strict//EN",
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd");
$this->_html_render_type = $GLOBALS["HTML_RENDER_TYPE"] = XHTML_STRICT;
$this->set_html_attributes( array( "xmlns" => "http://www.w3.org/1999/xhtml",
"xml:lang" => "en",
"lang" => "en") );
break;
case XHTML:
case XHTML_TRANSITIONAL:
$this->build_doctype("-//W3C//DTD XHTML 1.0 Transitional//EN",
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd");
$this->_html_render_type = $GLOBALS["HTML_RENDER_TYPE"] = XHTML;
$this->set_html_attributes( array( "xmlns" => "http://www.w3.org/1999/xhtml",
"xml:lang" => "en",
"lang" => "en") );
break;
//What else needs to be done to properly support
//XHTML frameset? TODO LIST for 1.1
case XHTML_FRAMESET:
$this->build_doctype("-//W3C//DTD XHTML 1.0 Frameset//EN",
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd");
$this->_html_render_type = $GLOBALS["HTML_RENDER_TYPE"] = XHTML_FRAMESET;
break;
}
$this->_head = new HEADtag;
$this->_head_js = html_script();
$this->_head_style = html_style();
$this->_create_body();
if ($title != NULL) {
$this->set_title( $title );
}
$this->_indent_style = $indent_style;
}
//**************************************************
//* HEAD tag related functions
//**************************************************
/**
* this adds content to the head tag
* of the page
*
* @param mixed - any content to add
*/
function add_head_content( ) {
$num_args = func_num_args();
for ($i=0;$i<$num_args;$i++) {
$this->_head->add(func_get_arg($i));
}
}
/**
* Same ass add_head_content()
*
* @deprecated - use add_head_content();
*/
function push_head_content( ) {
$args = func_get_args();
call_user_func_array( array(&$this, "add_head_content"), $args);
}
/**
* adds raw javascript to the head which
* will automatically get wrapped in a
*