/s3db3.5.10/pearlib/HTML/Common.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: Common.php,v 1.8 2003/06/19 18:52:50 mansion Exp $



/**

 * 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

?>