Cricao de Sites - 650 Layouts Prontos/WebMasters.iso/CMS/xoops-2.0.18.1.exe/xoops-2.0.18.1/htdocs/class/xoopsform/formselect.php

PHP Script | 2007-12-08 | 6.7 KB | 222 lines

<?php
// $Id: formselect.php 1162 2007-12-08 06:58:50Z phppp $
//  ------------------------------------------------------------------------ //
//                XOOPS - PHP Content Management System                      //
//                    Copyright (c) 2000 XOOPS.org                           //
//                       <http://www.xoops.org/>                             //
//  ------------------------------------------------------------------------ //
//  This program is free software; you can redistribute it and/or modify     //
//  it under the terms of the GNU General Public License as published by     //
//  the Free Software Foundation; either version 2 of the License, or        //
//  (at your option) any later version.                                      //
//                                                                           //
//  You may not change or alter any portion of this comment or credits       //
//  of supporting developers from this source code or any supporting         //
//  source code which is considered copyrighted (c) material of the          //
//  original comment or credit authors.                                      //
//                                                                           //
//  This program is distributed in the hope that it will be useful,          //
//  but WITHOUT ANY WARRANTY; without even the implied warranty of           //
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the            //
//  GNU General Public License for more details.                             //
//                                                                           //
//  You should have received a copy of the GNU General Public License        //
//  along with this program; if not, write to the Free Software              //
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA //
//  ------------------------------------------------------------------------ //
// Author: Kazumi Ono (AKA onokazu)                                          //
// URL: http://www.myweb.ne.jp/, http://www.xoops.org/, http://jp.xoops.org/ //
// Project: The XOOPS Project                                                //
// ------------------------------------------------------------------------- //
if (!defined('XOOPS_ROOT_PATH')) {
    die("XOOPS root path not defined");
}
/**
 * @package     kernel
 * @subpackage  form
 *
 * @author        Kazumi Ono    <[e-mail]>
 * @copyright    copyright (c) 2000-2003 XOOPS.org
 */

/**
 * A select field
 *
 * @package     kernel
 * @subpackage  form
 *
 * @author        Kazumi Ono    <[e-mail]>
 * @copyright    copyright (c) 2000-2003 XOOPS.org
 */
class XoopsFormSelect extends XoopsFormElement {

    /**
     * Options
     * @var array
     * @access    private
     */
    var $_options = array();

    /**
     * Allow multiple selections?
     * @var    bool
     * @access    private
     */
    var $_multiple = false;

    /**
     * Number of rows. "1" makes a dropdown list.
     * @var    int
     * @access    private
     */
    var $_size;

    /**
     * Pre-selcted values
     * @var    array
     * @access    private
     */
    var $_value = array();

    /**
     * Constructor
     *
     * @param    string    $caption    Caption
     * @param    string    $name       "name" attribute
     * @param    mixed    $value        Pre-selected value (or array of them).
     * @param    int        $size        Number or rows. "1" makes a drop-down-list
     * @param    bool    $multiple   Allow multiple selections?
     */
    function XoopsFormSelect($caption, $name, $value = null, $size = 1, $multiple = false){
        $this->setCaption($caption);
        $this->setName($name);
        $this->_multiple = $multiple;
        $this->_size = intval($size);
        if (isset($value)) {
            $this->setValue($value);
        }
    }

    /**
     * Are multiple selections allowed?
     *
     * @return    bool
     */
    function isMultiple() {
        return $this->_multiple;
    }

    /**
     * Get the size
     *
     * @return    int
     */
    function getSize() {
        return $this->_size;
    }

    /**
     * Get an array of pre-selected values
     *
     * @param    bool    $encode To sanitizer the text?
     * @return    array
     */
    function getValue($encode = false) {
        if (!$encode) {
            return $this->_value;
        }
        $value = array();
        foreach ($this->_value as $val) {
            $value[] = $val ? htmlspecialchars($val, ENT_QUOTES) : $val;
        }
        return $value;
    }

    /**
     * Set pre-selected values
     *
     * @param    $value    mixed
     */
    function setValue($value) {
        if (is_array($value)) {
            foreach ($value as $v) {
                $this->_value[] = $v;
            }
        } else {
            $this->_value[] = $value;
        }
    }

    /**
     * Add an option
     *
     * @param    string  $value  "value" attribute
     * @param    string  $name   "name" attribute
     */
    function addOption($value, $name = ""){
        if ( $name != "" ) {
            $this->_options[$value] = $name;
        } else {
            $this->_options[$value] = $value;
        }
    }

    /**
     * Add multiple options
     *
     * @param    array   $options    Associative array of value->name pairs
     */
    function addOptionArray($options) {
        if ( is_array($options) ) {
            foreach ( $options as $k=>$v ) {
                $this->addOption($k, $v);
            }
        }
    }

    /**
     * Get an array with all the options
     *
     * Note: both name and value should be sanitized. However for backward compatibility, only value is sanitized for now.
     *
     * @param    int     $encode     To sanitizer the text? potential values: 0 - skip; 1 - only for value; 2 - for both value and name
     * @return    array   Associative array of value->name pairs
     */
    function getOptions($encode = false) {
        if (!$encode) {
            return $this->_options;
        }
        $value = array();
        foreach ($this->_options as $val => $name) {
            $value[ $encode ? htmlspecialchars($val, ENT_QUOTES) : $val ] = ($encode > 1) ? htmlspecialchars($name, ENT_QUOTES) : $name;
        }
        return $value;
    }

    /**
     * Prepare HTML for output
     *
     * @return    string  HTML
     */
    function render() {
        $ele_name = $this->getName();
        $ele_value = $this->getValue();
        $ele_options = $this->getOptions();
        $ret = "<select size='".$this->getSize()."'".$this->getExtra();
        if ($this->isMultiple() != false) {
            $ret .= " name='".$ele_name."[]' id='".$ele_name."[]' multiple='multiple'>\n";
        } else {
            $ret .= " name='".$ele_name."' id='".$ele_name."'>\n";
        }
        foreach ( $ele_options as $value => $name ) {
            $ret .= "<option value='".htmlspecialchars($value, ENT_QUOTES)."'";
            if (count($ele_value) > 0 && in_array($value, $ele_value)) {
                    $ret .= " selected='selected'";
            }
            $ret .= ">".$name."</option>\n";
        }
        $ret .= "</select>";
        return $ret;
    }
}
?>