File indexing completed on 2024-12-22 05:37:13

 <?php
 /**
  * Zend Framework
  *
  * LICENSE
  *
  * This source file is subject to the new BSD license that is bundled
  * with this package in the file LICENSE.txt.
  * It is also available through the world-wide-web at this URL:
  * http://framework.zend.com/license/new-bsd
  * If you did not receive a copy of the license and are unable to
  * obtain it through the world-wide-web, please send an email
  * to license@zend.com so we can send you a copy immediately.
  *
  * @category   Zend
  * @package    Zend_View
  * @subpackage Helper
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  * @version    $Id$
  */
 
 /**
  * @see Zend_View_Helper_HtmlElement
  */
 // require_once 'Zend/View/Helper/HtmlElement.php';
 
 /**
  * Base helper for form elements.  Extend this, don't use it on its own.
  *
  * @category   Zend
  * @package    Zend_View
  * @subpackage Helper
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  */
 abstract class Zend_View_Helper_FormElement extends Zend_View_Helper_HtmlElement
 {
     /**
      * @var Zend_Translate_Adapter|null
      */
     protected $_translator;
 
     /**
      * Get translator
      *
      * @return Zend_Translate_Adapter|null
      */
     public function getTranslator()
     {
          return $this->_translator;
     }
 
     /**
      * Set translator
      *
      * @param  Zend_Translate|Zend_Translate_Adapter|null $translator
      * @return Zend_View_Helper_FormElement
      */
     public function setTranslator($translator = null)
     {
         if (null === $translator) {
             $this->_translator = null;
         } elseif ($translator instanceof Zend_Translate_Adapter) {
             $this->_translator = $translator;
         } elseif ($translator instanceof Zend_Translate) {
             $this->_translator = $translator->getAdapter();
         } else {
             // require_once 'Zend/View/Exception.php';
             $e = new Zend_View_Exception('Invalid translator specified');
             $e->setView($this->view);
             throw $e;
         }
          return $this;
     }
 
     /**
      * Converts parameter arguments to an element info array.
      *
      * E.g, formExample($name, $value, $attribs, $options, $listsep) is
      * the same thing as formExample(array('name' => ...)).
      *
      * Note that you cannot pass a 'disable' param; you need to pass
      * it as an 'attribs' key.
      *
      * @access protected
      *
      * @return array An element info array with keys for name, value,
      * attribs, options, listsep, disable, and escape.
      */
     protected function _getInfo($name, $value = null, $attribs = null,
         $options = null, $listsep = null
     ) {
         // the baseline info.  note that $name serves a dual purpose;
         // if an array, it's an element info array that will override
         // these baseline values.  as such, ignore it for the 'name'
         // if it's an array.
         $info = array(
             'name'    => is_array($name) ? '' : $name,
             'id'      => is_array($name) ? '' : $name,
             'value'   => $value,
             'attribs' => $attribs,
             'options' => $options,
             'listsep' => $listsep,
             'disable' => false,
             'escape'  => true,
         );
 
         // override with named args
         if (is_array($name)) {
             // only set keys that are already in info
             foreach ($info as $key => $val) {
                 if (isset($name[$key])) {
                     $info[$key] = $name[$key];
                 }
             }
 
             // If all helper options are passed as an array, attribs may have
             // been as well
             if (null === $attribs) {
                 $attribs = $info['attribs'];
             }
         }
 
         $attribs = (array)$attribs;
 
         // Normalize readonly tag
         if (array_key_exists('readonly', $attribs)) {
             $attribs['readonly'] = 'readonly';
         }
 
         // Disable attribute
         if (array_key_exists('disable', $attribs)) {
            if (is_scalar($attribs['disable'])) {
                 // disable the element
                 $info['disable'] = (bool)$attribs['disable'];
             } else if (is_array($attribs['disable'])) {
                 $info['disable'] = $attribs['disable'];
             }
         }
 
         // Set ID for element
         if (array_key_exists('id', $attribs)) {
             $info['id'] = (string)$attribs['id'];
         } else if ('' !== $info['name']) {
             $info['id'] = trim(strtr($info['name'],
                                      array('[' => '-', ']' => '')), '-');
         }
         
         // Remove NULL name attribute override
         if (array_key_exists('name', $attribs) && is_null($attribs['name'])) {
           unset($attribs['name']);
         }
         
         // Override name in info if specified in attribs
         if (array_key_exists('name', $attribs) && $attribs['name'] != $info['name']) {
             $info['name'] = $attribs['name'];
         }
 
         // Determine escaping from attributes
         if (array_key_exists('escape', $attribs)) {
             $info['escape'] = (bool)$attribs['escape'];
         }
 
         // Determine listsetp from attributes
         if (array_key_exists('listsep', $attribs)) {
             $info['listsep'] = (string)$attribs['listsep'];
         }
 
         // Remove attribs that might overwrite the other keys. We do this LAST
         // because we needed the other attribs values earlier.
         foreach ($info as $key => $val) {
             if (array_key_exists($key, $attribs)) {
                 unset($attribs[$key]);
             }
         }
         $info['attribs'] = $attribs;
 
         // done!
         return $info;
     }
 
     /**
      * Creates a hidden element.
      *
      * We have this as a common method because other elements often
      * need hidden elements for their operation.
      *
      * @access protected
      *
      * @param string $name The element name.
      * @param string $value The element value.
      * @param array  $attribs Attributes for the element.
      *
      * @return string A hidden element.
      */
     protected function _hidden($name, $value = null, $attribs = null)
     {
         return '<input type="hidden"'
              . ' name="' . $this->view->escape($name) . '"'
              . ' value="' . $this->view->escape($value) . '"'
              . $this->_htmlAttribs($attribs) . $this->getClosingBracket();
     }
 }