File Source for Menu.php

<?php
/**
* CNZ Framework
*
* A Framework for Creating and Using Complex Web Elements
*
* The purpose of this framework is to provide a library of high-level objects
* to facilitate common HTML coding tasks, such as menus, tables, and forms.
* The intent is to reduce repetitive HTML coding as much as possible, replacing
* it with a combination of configuration files and style sheets with
* standardized naming conventions.
*
* This framework is built on and requires the
* {@link http://framework.zend.com/ Zend Framework}.
*
* @category Cnz
* @package Cnz_Html
* @subpackage Menu
*
* @author Lyle Frost <lfrost@cnz.com>
* @copyright Copyright (c) 2006-2007 Citadel Network <{@link http://www.citadelnetwork.com/}>
* @filesource
* @license http://www.citadelnetwork.com/license/cnzframework New BSD License
* @version $Id: Menu.php 27 2007-07-19 18:47:54Z lfrost $
*/
/**
* Required classes.
*
* @ignore
*/
Zend_Loader::loadClass('Cnz_Html_Element');
Zend_Loader::loadClass('Cnz_Html_Menu_Item');
/**
* HTML Menu class
*
* This class asserts that the most appropriate structure for a menu is an
* unordered list enclosed in a div.
*
* Each configuration item value is of the form text,link. A blank item will
* cause a horizontal separator line to be created. For multiple blank lines,
* give each line a label, but no link value (e.g., LINE1:). If the text or
* link contains a colon, comma, or backslash, escape them with a backslash.
*
* Example INI (defaults shown as comments):
*
* <pre><samp>
* [HtmlMenuMain]
* list = "
* Home:/,
* About Us:/about/,
* Contact Us:/contact/,
* ,
* Careers:/career/,
* News:/news/,
* Citadel Network:http\://www.citadelnetwork.com/
* "
* </samp></pre>
*
* Example PHP:
*
* <code>
* Cnz_Html::loadAndDisplay('Cnz_Html_Menu', array('name' => 'main', 'config' => true, 'style' => true));
* </code>
*
* Example CSS:
*
* <pre><samp>
* div.menu-main
* {
* background-color: #FFE4E1;
* border-color: inherit;
* border-style: ridge;
* border-width: 0 0 3px 3px;
* color: inherit;
* clear: left;
* float: left;
* height: 190px;
* margin: 0;
* min-height: 400px;
* padding: 10px 0 0 0;
* width: 134px;
* }
* ul.menu-main
* {
* font-family: Helvetica,Helv,Arial,sans-serif;
* font-size: small;
* font-weight: bold;
* list-style-type: none;
* margin: 0;
* padding: 0 0 0 5px;
* text-align: left;
* }
* li.menu-main
* {
* }
* a[href].menu-main
* {
* text-decoration: none;
* background-color: inherit;
* color: #901E78;
* font-weight: normal;
* }
* a[href]:hover.menu-main
* {
* text-decoration: underline;
* background-color: inherit;
* color: #901E78;
* font-weight: bold;
* }
* hr.menu-main
* {
* background-color: inherit;
* color: black;
* margin: 0;
* padding: 0;
* }
* </samp></pre>
*
* Note that this class can also be used for horizontal menus by setting
* display:inline for <li>. Setting white-space:nowrap for <ul> may also
* be desired for horizontal menus.
*
* @category Cnz
* @package Cnz_Html
* @subpackage Menu
*/
class Cnz_Html_Menu extends Cnz_Html_Element
{
const HAS_CONFIG = true;
/**#@+ @var array */
private $itemArray = array();
/**#@-*/
/* Methods ===========================================================*/
/**
* Option fields:
* list Menu item list
*
* Configuration fields:
* list Menu item list
*
* @param array $options Options
*/
public function __construct(array $options = array())
{
parent::__construct($options);
if (isset($options['list'])) $menu = Cnz_Html::listToArray($options['list']);
else $menu = Cnz_Html::listToArray($this->config->list);
$count = count($menu);
$i = 0;
foreach ($menu as $text => $link)
{
$this->itemArray[$i++] = new Cnz_Html_Menu_Item($options, $text, $link);
}
return;
}
/**
* @param string $style Value for outermost style attribute
* @return void
*/
public function display($style = NULL)
{
$is = Cnz_Html::getIndentString();
$indent = Cnz_Html::indentGenerate();
echo $indent, '<div class = "', $this->genStyles(), '"';
echo ' id = "', $this->genId(), '"';
if (!empty($style)) echo ' style = "', $style, '"';
echo '>', "\n";
Cnz_Html::indentInc();
$indent = Cnz_Html::indentGenerate();
echo $indent, '<ul class = "', $this->genStyles(), '">', "\n";
Cnz_Html::indentInc();
$count = count($this->itemArray);
for ($i = 0; $i < $count; $i++)
{
$this->itemArray[$i]->display($this->name);
}
Cnz_Html::indentDec();
$indent = Cnz_Html::indentGenerate();
echo $indent, '</ul>', "\n";
Cnz_Html::indentDec();
$indent = Cnz_Html::indentGenerate();
echo $indent, '</div>', "\n";
return;
}
}

Source for file Menu.php