<?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) 2006 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */


/**
 * Abstract class for extension
 */
require_once 'Zend/View/Helper/FormElement.php';


/**
 * Helper to generate a "textarea" element
 * 
 * @category   Zend
 * @package    Zend_View
 * @subpackage Helper
 * @copyright  Copyright (c) 2006 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_View_Helper_FormTextarea extends Zend_View_Helper_FormElement {
    
    /**
     * The default number of rows for a textarea.
     * 
     * @access public
     * 
     * @var int
     */
    public $rows = 24;
    
    /**
     * The default number of columns for a textarea.
     * 
     * @access public
     * 
     * @var int
     */
    public $cols = 80;
    
    /**
     * Generates a 'textarea' element.
     * 
     * @access public
     * 
     * @param string|array $name If a string, the element name.  If an
     * array, all other parameters are ignored, and the array elements
     * are extracted in place of added parameters.
     * 
     * @param mixed $value The element value.
     * 
     * @param array $attribs Attributes for the element tag.
     * 
     * @return string The element XHTML.
     */
    public function formTextarea($name, $value = null, $attribs = null)
    {
        $info = $this->_getInfo($name, $value, $attribs);
        extract($info); // name, value, attribs, options, listsep, disable
        
        // build the element
        if ($disable) {
        
            // disabled.
            $xhtml = $this->_hidden($name, $value)
                   . nl2br(htmlspecialchars($value, ENT_COMPAT, 'UTF-8'));
            
        } else {
        
            // enabled.
            
            // first, make sure that there are 'rows' and 'cols' values
            // as required by the spec.  noted by Orjan Persson.
            if (empty($attribs['rows'])) {
                $attribs['rows'] = (int) $this->rows;
            }
            
            if (empty($attribs['cols'])) {
                $attribs['cols'] = (int) $this->cols;
            }
            
            // now build the element.
            $xhtml = '<textarea name="' . htmlspecialchars($name, ENT_COMPAT, 'UTF-8') . '"'
                   . ' id="' . htmlspecialchars($id, ENT_COMPAT, 'UTF-8') . '"'
                   . $this->_htmlAttribs($attribs) . '>'
                   . htmlspecialchars($value, ENT_COMPAT, 'UTF-8') . '</textarea>';
            
        }
        
        return $xhtml;
    }
}
