WebControls.php

浏览该文件的文档。

<?php
// FleaPHP Framework
//
// Copyright (c) 2005 - 2008 QeeYuan China Inc. (http://www.qeeyuan.com)
//
// 许可协议，请查看源代码中附带的 LICENSE.txt 文件，
// 或者访问 http://www.fleaphp.org/ 获得详细信息。

class FLEA_WebControls
{
    var $_extends = array();

    var $_extendsDir = array();

    function FLEA_WebControls($extendsDir = null)
    {
        if (is_array($extendsDir)) {
            $this->_extendsDir = array_merge($this->_extendsDir, $extendsDir);
        } elseif ($extendsDir != '') {
            $this->_extendsDir[] = $extendsDir;
        }
        $extendsDir = FLEA::getAppInf('webControlsExtendsDir');
        if (is_array($extendsDir)) {
            $this->_extendsDir = array_merge($this->_extendsDir, $extendsDir);
        } elseif ($extendsDir != '') {
            $this->_extendsDir[] = $extendsDir;
        }
    }

    function control($type, $name, $attribs = null, $return = false)
    {
        $type = strtolower($type);
        $render = '_ctl' . ucfirst($type);
        $attribs = (array)$attribs;

        $__ctl_out = false;
        if (method_exists($this, $render)) {
            $__ctl_out = $this->{$render}($name, $attribs);
        } else {
            $extfilename = ucfirst($type) . '.php';
            if (!isset($this->_extends[$type])) {
                foreach ($this->_extendsDir as $dir) {
                    if (file_exists($dir . DS . $extfilename)) {
                        require($dir . DS . $extfilename);
                        $this->_extends[$type] = true;
                        break;
                    }
                }
            }

            if (isset($this->_extends[$type])) {
                $__ctl_out = call_user_func_array($render,
                        array('name' => $name, 'attribs' => $attribs));
            }
        }

        if ($__ctl_out === false) {
            $__ctl_out = "INVALID CONTROL TYPE \"{$type}\"";
        }

        if ($return) { return $__ctl_out; }
        echo $__ctl_out;
        return '';
    }

    function attribsToString($attribs)
    {
        $__ctl_out = '';
        foreach ($attribs as $attrib => $value) {
            $__ctl_out .= $attrib . '="' . str_replace('"', '\'', $value) . '" ';
        }
        return $__ctl_out;
    }

    function extractAttribs(& $attribs, $req)
    {
        $extract = array();
        foreach ($req as $attrib) {
            if (array_key_exists($attrib, $attribs)) {
                $extract[$attrib] = $attribs[$attrib];
                unset($attribs[$attrib]);
            } else {
                $extract[$attrib] = null;
            }
        }
        return $extract;
    }

    function mergeAttribs(& $attribs)
    {
        $args = array();
        foreach ($attribs as $key => $arg) {
            if (is_array($arg)) {
                $args = array_merge($args, $arg);
            } else if (!is_null($arg)) {
                $args[$key] = $arg;
            }
        }
        $attribs = $args;
    }

    function & _getView()
    {
        $viewClass = FLEA::getAppInf('view');
        if ($viewClass != 'PHP') {
            return FLEA::getSingleton($viewClass);
        } else {
            $view = false;
            return $view;
        }
    }

    function _ctlTextbox($name, $attribs)
    {
        return $this->__baseCtlInput($name, $attribs, 'text');
    }

    function _ctlPassword($name, $attribs)
    {
        return $this->__baseCtlInput($name, $attribs, 'password');
    }

    function _ctlMemo($name, $attribs)
    {
        extract($this->extractAttribs($attribs, array('id', 'value', 'disabled')));
        if (empty($id)) { $id = $name; }

        $__ctl_out = '<textarea ';
        if ($name) {
            $__ctl_out .= 'name="' . h($name) . '" ';
            $__ctl_out .= 'id="' . h($id) . '" ';
        }
        $__ctl_out .= $this->attribsToString($attribs);
        if ($disabled) {
            $__ctl_out .= 'disabled="disabled" ';
        }
        $__ctl_out .= '>';
        $__ctl_out .= h($value);
        $__ctl_out .= '</textarea>';
        return $__ctl_out;
    }

    function _ctlCheckbox($name, $attribs)
    {
        return $this->__baseCtlCheckboxOrRadio($name, $attribs, 'checkbox');
    }

    function _ctlCheckBoxGroup($name, $attribs)
    {
        return $this->__baseCtlCheckboxOrRadioGroup($name, $attribs, 'checkbox', '[]');
    }

    function _ctlRadio($name, $attribs)
    {
        return $this->__baseCtlCheckboxOrRadio($name, $attribs, 'radio');
    }

    function _ctlRadioGroup($name, $attribs)
    {
        return $this->__baseCtlCheckboxOrRadioGroup($name, $attribs, 'radio', '');
    }

    function _ctlListBox($name, $attribs)
    {
        extract($this->extractAttribs($attribs,
                array('id', 'size', 'items', 'selected', 'multiple', 'disabled', 'key', 'caption')));
        if (empty($id)) { $id = $name; }

        if (!is_array($selected) && substr($selected, 0, 1) == ':') {
            $selected = intval(substr($selected, 1));
            $selectedByIndex = true;
        } else {
            $selectedByIndex = false;
        }
        $__ctl_out = '<select ';
        if ($name) {
            $__ctl_out .= 'name="' . h($name) . '" ';
            $__ctl_out .= 'id="' . h($id) . '" ';
        }
        if ($size <= 0) {
            $size = 4;
        }
        $__ctl_out .= 'size="' . $size . '" ';
        if ($multiple) {
            $__ctl_out .= 'multiple="multiple" ';
        }
        if ($disabled) {
            $__ctl_out .= 'disabled="disabled" ';
        }
        $__ctl_out .= $this->attribsToString($attribs);
        $__ctl_out .= ">\n";

        $items = (array)$items;

        if ($key) {
            if (!$this->__processMultiDimArray($items, $key, $caption)) {
                return 'INVALID ITEMS';
            }
        }

        $ix = 0;
        foreach ($items as $caption => $value) {
            $__ctl_out .= '<option value="' . h($value) . '" ';
            $checked = false;
            if ($selectedByIndex) {
                if (is_array($selected)) {
                    if (in_array($ix, $selected)) {
                        $checked = true;
                    }
                } else if ($ix == $selected) {
                    $checked = true;
                }
            } else {
                if (is_array($selected)) {
                    if (in_array($value, $selected)) {
                        $checked = true;
                    }
                } else if ($value == $selected) {
                    $checked = true;
                }
            }
            if ($checked) {
                $__ctl_out .= 'selected="selected" ';
            }
            $__ctl_out .= '>';
            $__ctl_out .= h($caption);
            $__ctl_out .= "</option>\n";
            $ix++;
        }
        $__ctl_out .= "</select>\n";
        return $__ctl_out;
    }

    function _ctlDropdownList($name, $attribs)
    {
        extract($this->extractAttribs($attribs,
                array('id', 'items', 'selected', 'disabled', 'key', 'caption')));
        if (empty($id)) { $id = $name; }

        if (substr($selected, 0, 1) == ':') {
            $selected = intval(substr($selected, 1));
            $selectedByIndex = true;
        } else {
            $selectedByIndex = false;
        }
        $__ctl_out = '<select ';
        if ($name) {
            $__ctl_out .= 'name="' . h($name) . '" ';
            $__ctl_out .= 'id="' . h($id) . '" ';
        }
        if ($disabled) {
            $__ctl_out .= 'disabled="disabled" ';
        }
        $__ctl_out .= $this->attribsToString($attribs);
        $__ctl_out .= ">\n";

        $items = (array)$items;

        if ($key) {
            if (!$this->__processMultiDimArray($items, $key, $caption)) {
                return 'INVALID ITEMS';
            }
        }

        $ix = 0;
        foreach ($items as $caption => $value) {
            $__ctl_out .= '<option value="' . h($value) . '" ';
            if ($selectedByIndex) {
                if ($ix == $selected) {
                    $__ctl_out .= 'selected="selected" ';
                }
            } else {
                if ($value == $selected) {
                    $__ctl_out .= 'selected="selected" ';
                }
            }
            $__ctl_out .= '>';
            $__ctl_out .= h($caption);
            $__ctl_out .= "</option>\n";
            $ix++;
        }
        $__ctl_out .= "</select>\n";
        return $__ctl_out;
    }

    function _ctlFileUpload($name, $attribs)
    {
        return $this->__baseCtlInput($name, $attribs, 'file');
    }

    function _ctlButton($name, $attribs, $buttonType = 'button')
    {
        extract($this->extractAttribs($attribs, array('caption')));
        if ($caption != '') { $attribs['value'] = $caption; }
        return $this->__baseCtlInput($name, $attribs, $buttonType);
    }

    function _ctlSubmit($name, $attribs)
    {
        return $this->_ctlButton($name, $attribs, 'submit');
    }

    function _ctlReset($name, $attribs)
    {
        return $this->_ctlButton($name, $attribs, 'reset');
    }

    function _ctlLabel($name, $attribs)
    {
        extract($this->extractAttribs($attribs, array('id', 'caption')));
        if (empty($id)) { $id = $name; }

        $__ctl_out = '<label ';
        if ($name) {
            $__ctl_out .= 'name="' . h($name) . '" ';
            $__ctl_out .= 'id="' . h($id) . '" ';
        }
        $__ctl_out .= $this->attribsToString($attribs);
        $__ctl_out .= '>';
        $__ctl_out .= h($caption);
        $__ctl_out .= '</label>';
        return $__ctl_out;
    }


    function _ctlStatic($name, $attribs)
    {
        extract($this->extractAttribs($attribs, array('id', 'value')));
        if (empty($id)) { $id = $name; }

        $__ctl_out = '<div ';
        if ($name) {
            $__ctl_out .= 'name="' . h($name) . '" ';
            $__ctl_out .= 'id="' . h($id) . '" ';
        }
        $__ctl_out .= $this->attribsToString($attribs);
        $__ctl_out .= '>';
        $__ctl_out .= h($value);
        $__ctl_out .= '</div>';
        return $__ctl_out;
    }

    function _ctlHidden($name, $attribs)
    {
        return $this->__baseCtlInput($name, $attribs, 'hidden');
    }

    function __baseCtlInput($name, $attribs, $type)
    {
        extract($this->extractAttribs($attribs, array('id', 'value', 'disabled')));
        if (empty($id)) { $id = $name; }

        $__ctl_out = "<input type=\"{$type}\" ";
        if ($name) {
            $__ctl_out .= 'name="' . h($name) . '" ';
            $__ctl_out .= 'id="' . h($id) . '" ';
        }
        $__ctl_out .= 'value="' . h($value) . '" ';
        $__ctl_out .= $this->attribsToString($attribs);
        if ($disabled) {
            $__ctl_out .= 'disabled="disabled" ';
        }
        $__ctl_out .= '/>';
        return $__ctl_out;
    }

    function __baseCtlCheckboxOrRadio($name, $attribs, $type)
    {
        extract($this->extractAttribs($attribs,
                array('id', 'value', 'checked', 'disabled', 'caption')));
        if (empty($id)) { $id = $name; }

        $__ctl_out = "<input type=\"{$type}\" ";
        if ($name) {
            $__ctl_out .= 'name="' . h($name) . '" ';
            $__ctl_out .= 'id="' . h($id) . '" ';
        }
        if (strlen($value) == 0) { $value = 1; }
        $__ctl_out .= 'value="' . h($value) . '" ';
        $__ctl_out .= $this->attribsToString($attribs);
        if ($checked) {
            $__ctl_out .= 'checked="checked" ';
        }
        if ($disabled) {
            $__ctl_out .= 'disabled="disabled" ';
        }
        $__ctl_out .= '/>';
        if (strlen($caption)) {
            $__ctl_out .= $this->_ctlLabel(null, array('for' => $id, 'caption' => $caption));
        }
        return $__ctl_out;
    }

    function __baseCtlCheckboxOrRadioGroup($name, $attribs, $type, $suffix)
    {
        static $idSuffix = 1;

        extract($this->extractAttribs($attribs, array('items', 'selected', 'disabled',
                'multirow', 'cols', 'key', 'caption', 'table', 'border', 'cellspacing',
                'cellpadding', 'key2caption')));

        if (!is_array($selected) && substr($selected, 0, 1) == ':') {
            $selected = intval(substr($selected, 1));
            $selectedByIndex = true;
        } else {
            $selectedByIndex = false;
        }

        $__ctl_out = '';
        $items = (array)$items;
        $max = count($items);
        if ($max <= 0) { return ''; }

        if ($key) {
            if (!$this->__processMultiDimArray($items, $key, $caption, $key2caption)) {
                return 'INVALID ITEMS';
            }
        } else if ($key2caption) {
            $tmp = array();
            foreach ($items as $caption => $key) {
                $tmp[$key] = $caption;
            }
            $items = $tmp;
        }

        $ix = 0;
        $col = 0;
        if ($table) {
            $border = is_null($border) ? 0 : $border;
            $cellspacing = is_null($cellspacing) ? 0 : $cellspacing;
            $cellpadding = is_null($cellpadding) ? 0 : $cellpadding;
            $__ctl_out .= "<table border=\"{$border}\" cellspacing=\"{$cellspacing}\" cellpadding=\"{$cellpadding}\">\n";
            if ($multirow) { $__ctl_out .= "<tr>\n"; }
        }
        foreach ($items as $caption => $value) {
            if ($table) { $__ctl_out .= "<td>"; }
            $checked = false;
            if ($selectedByIndex) {
                if (is_array($selected)) {
                    if (in_array($ix, $selected)) { $checked = true; }
                } else if ($ix == $selected) {
                    $checked = true;
                }
            } else {
                if (is_array($selected)) {
                    if (in_array($value, $selected)) { $checked = true; }
                } else if ($value == $selected) {
                    $checked = true;
                }
            }

            $__ctl_out .= "<input type=\"{$type}\" ";
            if ($name) {
                $__ctl_out .= 'name="' . h($name) . $suffix . '" ';
                $idSuffix++;
                $__ctl_out .= 'id="' . h($name) . "_{$idSuffix}\" ";
            }
            if (strlen($value) == 0) { $value = 1; }
            $__ctl_out .= 'value="' . h($value) . '" ';
            $__ctl_out .= $this->attribsToString($attribs);
            if ($checked) {
                $__ctl_out .= 'checked="checked" ';
            }
            if ($disabled) {
                $__ctl_out .= 'disabled="disabled" ';
            }
            $__ctl_out .= '/>';
            if ($caption) {
                $__ctl_out .= $this->_ctlLabel(null, array(
                    'for' => "{$name}_{$idSuffix}", 'caption' => $caption
                ));
            }

            if ($ix < $max) {
                if ($multirow) {
                    if ($cols) {
                        $col++;
                        if ($col >= $cols) {
                            if ($table) { $__ctl_out .= "</td>\n</tr>\n<tr>\n"; }
                            else { $__ctl_out .= "<br />\n"; }
                            $col = 0;
                        } else {
                            if ($table) { $__ctl_out .= "</td>\n"; }
                            else { $__ctl_out .= "&nbsp;&nbsp;\n"; }
                        }
                    } else {
                        if ($table) { $__ctl_out .= "</td>\n</tr>\n<tr>\n"; }
                        else { $__ctl_out .= "<br />\n"; }
                    }
                } else {
                    if ($table) { $__ctl_out .= "</td>\n"; }
                    else { $__ctl_out .= "&nbsp;&nbsp;\n"; }
                }
            }

            $ix++;
        }

        if ($table) {
            if ($cols && $ix % $cols > 0) {
               $__ctl_out .= str_repeat("<td>&nbsp;</td>\n", $cols - $ix % $cols);
            }
            $__ctl_out .= "</tr>\n</table>\n";
        }
        return $__ctl_out;
    }

    function __processMultiDimArray(& $items, & $key, & $caption, $key2caption = false)
    {
        if ($caption == '') {
            $first = reset($items);
            if (!is_array($first)) { return false; }
            next($first);
            $caption = key($first);
        }

        // 传入的 items 是一个多维数组
        $new = array();
        if ($key2caption) {
            foreach ($items as $item) {
                $new[$item[$key]] = $item[$caption];
            }
        } else {
            foreach ($items as $item) {
                $new[$item[$caption]] = $item[$key];
            }
        }
        $items = $new;
        return true;
    }
}

---