home *** CD-ROM | disk | FTP | other *** search
/ Cricao de Sites - 650 Layouts Prontos / WebMasters.iso / Servidores / xampp-win32-1.6.7-installer.exe / php / PEAR / HTML / QuickForm2 / Element / Button.php next >
Encoding:
PHP Script  |  2008-07-02  |  5.1 KB  |  160 lines

  1. <?php
  2. /**
  3.  * Class for <button> elements
  4.  *
  5.  * PHP version 5
  6.  *
  7.  * LICENSE:
  8.  * 
  9.  * Copyright (c) 2006, 2007, Alexey Borzov <avb@php.net>,
  10.  *                           Bertrand Mansion <golgote@mamasam.com>
  11.  * All rights reserved.
  12.  *
  13.  * Redistribution and use in source and binary forms, with or without
  14.  * modification, are permitted provided that the following conditions
  15.  * are met:
  16.  *
  17.  *    * Redistributions of source code must retain the above copyright
  18.  *      notice, this list of conditions and the following disclaimer.
  19.  *    * Redistributions in binary form must reproduce the above copyright
  20.  *      notice, this list of conditions and the following disclaimer in the 
  21.  *      documentation and/or other materials provided with the distribution.
  22.  *    * The names of the authors may not be used to endorse or promote products 
  23.  *      derived from this software without specific prior written permission.
  24.  *
  25.  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
  26.  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
  27.  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  28.  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
  29.  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  30.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  31.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  32.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  33.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  34.  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  35.  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  36.  *
  37.  * @category   HTML
  38.  * @package    HTML_QuickForm2
  39.  * @author     Alexey Borzov <avb@php.net>
  40.  * @author     Bertrand Mansion <golgote@mamasam.com>
  41.  * @license    http://opensource.org/licenses/bsd-license.php New BSD License
  42.  * @version    CVS: $Id: Button.php,v 1.4 2007/06/30 20:36:00 avb Exp $
  43.  * @link       http://pear.php.net/package/HTML_QuickForm2
  44.  */
  45.  
  46. /**
  47.  * Base class for simple HTML_QuickForm2 elements  
  48.  */
  49. require_once 'HTML/QuickForm2/Element.php';
  50.  
  51. /**
  52.  * Class for <button> elements
  53.  * 
  54.  * Note that this element was named 'xbutton' in previous version of QuickForm,
  55.  * the name 'button' being used for current 'inputbutton' element.   
  56.  *
  57.  * @category   HTML
  58.  * @package    HTML_QuickForm2
  59.  * @author     Alexey Borzov <avb@php.net>
  60.  * @author     Bertrand Mansion <golgote@mamasam.com>
  61.  * @version    Release: 0.2.0
  62.  */
  63. class HTML_QuickForm2_Element_Button extends HTML_QuickForm2_Element
  64. {
  65.    /**
  66.     * Contains options and data used for the element creation
  67.     * - content: Content to be displayed between <button></button> tags
  68.     * @var  array
  69.     */
  70.     protected $data = array('content' => '');
  71.  
  72.    /**
  73.     * Element's submit value 
  74.     * @var  string
  75.     */
  76.     protected $submitValue = null;
  77.  
  78.  
  79.     public function getType()
  80.     {
  81.         return 'button';
  82.     }
  83.  
  84.    /**
  85.     * Buttons can not be frozen
  86.     *
  87.     * @param    bool    Whether element should be frozen or editable. This 
  88.     *                   parameter is ignored in case of buttons
  89.     * @return   bool    Always returns false
  90.     */  
  91.     public function toggleFrozen($freeze = null)
  92.     {
  93.         return false;
  94.     }
  95.  
  96.    /**
  97.     * Sets the contents of the button element
  98.     *
  99.     * @param    string  Button content (HTML to add between <button></button> tags)
  100.     */
  101.     function setContent($content)
  102.     {
  103.         $this->data['content'] = $content;
  104.     }
  105.  
  106.    /**
  107.     * Button's value cannot be set via this method
  108.     *
  109.     * @param    mixed   Element's value, this parameter is ignored
  110.     * @return   HTML_QuickForm2_Element_Button
  111.     */
  112.     public function setValue($value)
  113.     {
  114.         return $this;
  115.     }
  116.  
  117.    /**
  118.     * Returns the element's value
  119.     *
  120.     * The value is only returned if the following is true
  121.     *  - button has 'type' attribute set to 'submit' (or no 'type' attribute)
  122.     *  - the form was submitted by clicking on this button
  123.     * 
  124.     * This method returns the actual value submitted by the browser. Note that 
  125.     * different browsers submit different values!
  126.     *
  127.     * @return    string|null
  128.     */ 
  129.     public function getValue()
  130.     {
  131.         if ((empty($this->attributes['type']) || 'submit' == $this->attributes['type']) &&
  132.             !$this->getAttribute('disabled'))
  133.         {
  134.             return $this->submitValue;
  135.         } else {
  136.             return null;
  137.         }
  138.     }
  139.  
  140.     public function __toString()
  141.     {
  142.         return $this->getIndent() . '<button' . $this->getAttributes(true) .
  143.                '>' . $this->data['content'] . '</button>';
  144.     }
  145.  
  146.     protected function updateValue()
  147.     {
  148.         foreach ($this->getDataSources() as $ds) {
  149.             if ($ds instanceof HTML_QuickForm2_DataSource_Submit &&
  150.                 null !== ($value = $ds->getValue($this->getName())))
  151.             {
  152.                 $this->submitValue = $value;
  153.                 return;
  154.             }
  155.         }
  156.         $this->submitValue = null;
  157.     }
  158. }
  159. ?>
  160.