419 Zeilen
11 KiB
PHP
419 Zeilen
11 KiB
PHP
<?php
|
|
/* vim: set expandtab tabstop=4 shiftwidth=4: */
|
|
// +----------------------------------------------------------------------+
|
|
// | PHP Version 4 |
|
|
// +----------------------------------------------------------------------+
|
|
// | Copyright (c) 1997, 1998, 1999, 2000, 2001 The PHP Group |
|
|
// +----------------------------------------------------------------------+
|
|
// | This source file is subject to version 2.0 of the PHP license, |
|
|
// | that is bundled with this package in the file LICENSE, and is |
|
|
// | available at through the world-wide-web at |
|
|
// | http://www.php.net/license/2_02.txt. |
|
|
// | If you did not receive a copy of the PHP license and are unable to |
|
|
// | obtain it through the world-wide-web, please send a note to |
|
|
// | license@php.net so we can mail you a copy immediately. |
|
|
// +----------------------------------------------------------------------+
|
|
// | Author: Adam Daniel <adaniel1@eesus.jnj.com> |
|
|
// +----------------------------------------------------------------------+
|
|
//
|
|
// $Id$
|
|
|
|
/**
|
|
* Base class for all HTML classes
|
|
*
|
|
* @author Adam Daniel <adaniel1@eesus.jnj.com>
|
|
* @version 1.7
|
|
* @since PHP 4.0.3pl1
|
|
* @abstract
|
|
*/
|
|
class HTML_Common {
|
|
|
|
/**
|
|
* Associative array of table attributes
|
|
* @var array
|
|
* @access private
|
|
*/
|
|
var $_attributes = array();
|
|
|
|
/**
|
|
* Tab offset of the table
|
|
* @var int
|
|
* @access private
|
|
*/
|
|
var $_tabOffset = 0;
|
|
|
|
/**
|
|
* Tab string
|
|
* @var string
|
|
* @since 1.7
|
|
* @access private
|
|
*/
|
|
var $_tab = "\11";
|
|
|
|
/**
|
|
* Contains the line end string
|
|
* @var string
|
|
* @since 1.7
|
|
* @access private
|
|
*/
|
|
var $_lineEnd = "\12";
|
|
|
|
/**
|
|
* HTML comment on the object
|
|
* @var string
|
|
* @since 1.5
|
|
* @access private
|
|
*/
|
|
var $_comment = '';
|
|
|
|
/**
|
|
* Class constructor
|
|
* @param mixed $attributes Associative array of table tag attributes
|
|
* or HTML attributes name="value" pairs
|
|
* @param int $tabOffset Indent offset in tabs
|
|
* @access public
|
|
*/
|
|
function HTML_Common($attributes = null, $tabOffset = 0)
|
|
{
|
|
$this->setAttributes($attributes);
|
|
$this->setTabOffset($tabOffset);
|
|
} // end constructor
|
|
|
|
/**
|
|
* Returns the current API version
|
|
* @access public
|
|
* @returns double
|
|
*/
|
|
function apiVersion()
|
|
{
|
|
return 1.7;
|
|
} // end func apiVersion
|
|
|
|
/**
|
|
* Returns the lineEnd
|
|
*
|
|
* @since 1.7
|
|
* @access private
|
|
* @return string
|
|
* @throws
|
|
*/
|
|
function _getLineEnd()
|
|
{
|
|
return $this->_lineEnd;
|
|
} // end func getLineEnd
|
|
|
|
/**
|
|
* Returns a string containing the unit for indenting HTML
|
|
*
|
|
* @since 1.7
|
|
* @access private
|
|
* @return string
|
|
*/
|
|
function _getTab()
|
|
{
|
|
return $this->_tab;
|
|
} // end func _getTab
|
|
|
|
/**
|
|
* Returns a string containing the offset for the whole HTML code
|
|
*
|
|
* @return string
|
|
* @access private
|
|
*/
|
|
function _getTabs()
|
|
{
|
|
return str_repeat($this->_getTab(), $this->_tabOffset);
|
|
} // end func _getTabs
|
|
|
|
/**
|
|
* Returns an HTML formatted attribute string
|
|
* @param array $attributes
|
|
* @return string
|
|
* @access private
|
|
*/
|
|
function _getAttrString($attributes)
|
|
{
|
|
$strAttr = '';
|
|
|
|
if (is_array($attributes)) {
|
|
foreach ($attributes as $key => $value) {
|
|
$strAttr .= ' ' . $key . '="' . htmlspecialchars($value) . '"';
|
|
}
|
|
}
|
|
return $strAttr;
|
|
} // end func _getAttrString
|
|
|
|
/**
|
|
* Returns a valid atrributes array from either a string or array
|
|
* @param mixed $attributes Either a typical HTML attribute string or an associative array
|
|
* @access private
|
|
*/
|
|
function _parseAttributes($attributes)
|
|
{
|
|
if (is_array($attributes)) {
|
|
$ret = array();
|
|
foreach ($attributes as $key => $value) {
|
|
if (is_int($key)) {
|
|
$key = $value = strtolower($value);
|
|
} else {
|
|
$key = strtolower($key);
|
|
}
|
|
$ret[$key] = $value;
|
|
}
|
|
return $ret;
|
|
|
|
} elseif (is_string($attributes)) {
|
|
$preg = "/(([A-Za-z_:]|[^\\x00-\\x7F])([A-Za-z0-9_:.-]|[^\\x00-\\x7F])*)" .
|
|
"([ \\n\\t\\r]+)?(=([ \\n\\t\\r]+)?(\"[^\"]*\"|'[^']*'|[^ \\n\\t\\r]*))?/";
|
|
if (preg_match_all($preg, $attributes, $regs)) {
|
|
for ($counter=0; $counter<count($regs[1]); $counter++) {
|
|
$name = $regs[1][$counter];
|
|
$check = $regs[0][$counter];
|
|
$value = $regs[7][$counter];
|
|
if (trim($name) == trim($check)) {
|
|
$arrAttr[strtolower(trim($name))] = strtolower(trim($name));
|
|
} else {
|
|
if (substr($value, 0, 1) == "\"" || substr($value, 0, 1) == "'") {
|
|
$value = substr($value, 1, -1);
|
|
}
|
|
$arrAttr[strtolower(trim($name))] = trim($value);
|
|
}
|
|
}
|
|
return $arrAttr;
|
|
}
|
|
}
|
|
} // end func _parseAttributes
|
|
|
|
/**
|
|
* Returns the array key for the given non-name-value pair attribute
|
|
*
|
|
* @param string $attr Attribute
|
|
* @param array $attributes Array of attribute
|
|
* @since 1.0
|
|
* @access private
|
|
* @return array key
|
|
* @throws
|
|
*/
|
|
function _getAttrKey($attr, $attributes)
|
|
{
|
|
if (isset($attributes[strtolower($attr)])) {
|
|
return true;
|
|
} else {
|
|
return null;
|
|
}
|
|
} //end func _getAttrKey
|
|
|
|
/**
|
|
* Updates the attributes in $attr1 with the values in $attr2 without changing the other existing attributes
|
|
* @param array $attr1 Original attributes array
|
|
* @param array $attr2 New attributes array
|
|
* @access private
|
|
* @return array
|
|
*/
|
|
function _updateAttrArray(&$attr1, $attr2)
|
|
{
|
|
if (!is_array($attr2)) {
|
|
return false;
|
|
}
|
|
foreach ($attr2 as $key => $value) {
|
|
$attr1[$key] = $value;
|
|
}
|
|
} // end func _updateAtrrArray
|
|
|
|
/**
|
|
* Removes the given attribute from the given array
|
|
*
|
|
* @param string $attr Attribute name
|
|
* @param array $attributes Attribute array
|
|
* @since 1.4
|
|
* @access public
|
|
* @return void
|
|
* @throws
|
|
*/
|
|
function _removeAttr($attr, &$attributes)
|
|
{
|
|
$attr = strtolower($attr);
|
|
if (isset($attributes[$attr])) {
|
|
unset($attributes[$attr]);
|
|
}
|
|
} //end func _removeAttr
|
|
|
|
/**
|
|
* Returns the value of the given attribute
|
|
*
|
|
* @param string $attr Attribute name
|
|
* @since 1.5
|
|
* @access public
|
|
* @return void
|
|
* @throws
|
|
*/
|
|
function getAttribute($attr)
|
|
{
|
|
$attr = strtolower($attr);
|
|
if (isset($this->_attributes[$attr])) {
|
|
return $this->_attributes[$attr];
|
|
}
|
|
return null;
|
|
} //end func getAttribute
|
|
|
|
/**
|
|
* Sets the HTML attributes
|
|
* @param mixed $attributes Either a typical HTML attribute string or an associative array
|
|
* @access public
|
|
*/
|
|
function setAttributes($attributes)
|
|
{
|
|
$this->_attributes = $this->_parseAttributes($attributes);
|
|
} // end func setAttributes
|
|
|
|
/**
|
|
* Returns the assoc array (default) or string of attributes
|
|
*
|
|
* @param bool Whether to return the attributes as string
|
|
* @since 1.6
|
|
* @access public
|
|
* @return mixed attributes
|
|
*/
|
|
function getAttributes($asString = false)
|
|
{
|
|
if ($asString) {
|
|
return $this->_getAttrString($this->_attributes);
|
|
} else {
|
|
return $this->_attributes;
|
|
}
|
|
} //end func getAttributes
|
|
|
|
/**
|
|
* Updates the passed attributes without changing the other existing attributes
|
|
* @param mixed $attributes Either a typical HTML attribute string or an associative array
|
|
* @access public
|
|
*/
|
|
function updateAttributes($attributes)
|
|
{
|
|
$this->_updateAttrArray($this->_attributes, $this->_parseAttributes($attributes));
|
|
} // end func updateAttributes
|
|
|
|
/**
|
|
* Removes an attribute
|
|
*
|
|
* @param string $attr Attribute name
|
|
* @since 1.4
|
|
* @access public
|
|
* @return void
|
|
* @throws
|
|
*/
|
|
function removeAttribute($attr)
|
|
{
|
|
$this->_removeAttr($attr, $this->_attributes);
|
|
} //end func removeAttribute
|
|
|
|
/**
|
|
* Sets the line end style to Windows, Mac, Unix or a custom string.
|
|
*
|
|
* @param string $style "win", "mac", "unix" or custom string.
|
|
* @since 1.7
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
function setLineEnd($style)
|
|
{
|
|
switch ($style) {
|
|
case 'win':
|
|
$this->_lineEnd = "\15\12";
|
|
break;
|
|
case 'unix':
|
|
$this->_lineEnd = "\12";
|
|
break;
|
|
case 'mac':
|
|
$this->_lineEnd = "\15";
|
|
break;
|
|
default:
|
|
$this->_lineEnd = $style;
|
|
}
|
|
} // end func setLineEnd
|
|
|
|
/**
|
|
* Sets the tab offset
|
|
*
|
|
* @param int $offset
|
|
* @access public
|
|
*/
|
|
function setTabOffset($offset)
|
|
{
|
|
$this->_tabOffset = $offset;
|
|
} // end func setTabOffset
|
|
|
|
/**
|
|
* Returns the tabOffset
|
|
*
|
|
* @since 1.5
|
|
* @access public
|
|
* @return int
|
|
*/
|
|
function getTabOffset()
|
|
{
|
|
return $this->_tabOffset;
|
|
} //end func getTabOffset
|
|
|
|
/**
|
|
* Sets the string used to indent HTML
|
|
*
|
|
* @since 1.7
|
|
* @param string $string String used to indent ("\11", "\t", ' ', etc.).
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
function setTab($string)
|
|
{
|
|
$this->_tab = $string;
|
|
} // end func setTab
|
|
|
|
/**
|
|
* Sets the HTML comment to be displayed at the beginning of the HTML string
|
|
*
|
|
* @param string
|
|
* @since 1.4
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
function setComment($comment)
|
|
{
|
|
$this->_comment = $comment;
|
|
} // end func setHtmlComment
|
|
|
|
/**
|
|
* Returns the HTML comment
|
|
*
|
|
* @since 1.5
|
|
* @access public
|
|
* @return string
|
|
*/
|
|
function getComment()
|
|
{
|
|
return $this->_comment;
|
|
} //end func getComment
|
|
|
|
/**
|
|
* Abstract method. Must be extended to return the objects HTML
|
|
*
|
|
* @access public
|
|
* @return string
|
|
* @abstract
|
|
*/
|
|
function toHtml()
|
|
{
|
|
return '';
|
|
} // end func toHtml
|
|
|
|
/**
|
|
* Displays the HTML to the screen
|
|
*
|
|
* @access public
|
|
*/
|
|
function display()
|
|
{
|
|
print $this->toHtml();
|
|
} // end func display
|
|
|
|
} // end class HTML_Common
|
|
?>
|