Validator - The source code for the component with sample code and tutorial (+) web-expert.dk

Validator, PHP source code

Den fulde PHP kildekode for Validator klassen

<?php
/**
 * @package validator
 * @filesource
 * @see HTML_VALIDATOR_COMPONENT_PATH.'/Validator.php'
 * @copyright (c) http://Finn-Rasmussen.com
 * @license http://Finn-Rasmussen.com/license/ myPHP License conditions
 * @author http://Finn-Rasmussen.com
 * @version 1.11
 * @since 27-nov-2009
 */

/**
 * The required files
 */
require_once(HTML_BASE_COMMON_PATH.'/Html.php');
require_once(HTML_BASE_UTIL_PATH.'/Ul.php');
require_once(HTML_BASE_UTIL_PATH.'/Li.php');
require_once(HTML_BASIC_UTIL_PATH.'/Singleton.php');
require_once(HTML_VALIDATOR_COMPONENT_PATH.'/ValidatorErrorList.php');
if (defined('HTML_LANGUAGE_UTIL_PATH')) {
    require_once(HTML_LANGUAGE_UTIL_PATH.'/Translate.php');
}

/**
 * Validates the different controls for a form. Ready to use
 * 
 * 
 * @todo how do I use this validator ????????????????????????
 * - should check the boundaries, pattern, 
 * - should generate localized error messages
 * 
 * <code>
 * Usage:
 *   $validator = new Validator();
 *   print $validator->getHtml();
 * Or
 *   print $validator->getStart();
 *   print $validator->getEnd();
 * Or
 *   Validator::start();
 *   Validator::end();
 * Or
 *   Validator::display();
 * </code>
 * @package validator
 */

class Validator extends Html {
    /**
     * Constructor
     */
    function __construct() {
        parent::__construct();
       }
       
    /**
     * Returns the html for the start of the control 
     * @return String the html
     */
    function getStart() {
        $html  = '';
        $ul = new Ul(CSS_ERROR);
           $errorlist = & Singleton::getInstance(CLASS_VALIDATOR_ERROR_LIST);
        $html .= $errorlist->size() != 0 ? $ul->getStart() : "";
        $html .= $this->getErrorList();
        return $html;
    }

    /**
     * Returns the html for the end of the control 
     * @return String the complete html
     */
    function getEnd() {
        $ul = new Ul(CSS_ERROR);
        $errorlist = & Singleton::getInstance(CLASS_VALIDATOR_ERROR_LIST);
        return $errorlist->size() != 0 ? $ul->getEnd() : "";
    }

    /**
     * Returns the list of the accumulated error messages as html
     * surronded by LI tags
     * @static 
     * @return array The list of error messages
     */
    function getErrorList() {
        $html = '';
        $li   = new Li();
           $errorlist = & Singleton::getInstance(CLASS_VALIDATOR_ERROR_LIST);
        foreach($errorlist->getErrorList() as $key=>$error) {
            $translatedText = $key;
            if (defined('HTML_LANGUAGE_UTIL_PATH')) {
                $translatedText = Translate::sql($key);
            }
            $html .= $li->getStart()."<b>$translatedText</b><br />";
            if (is_array($error)) {
                foreach($error as $key=>$value) {
                    switch($key) {
                        case HTML_ATTRIBUTE_MSG:
                            $html .= " $value";
                            break;
                        default:
                            //$html .= "<!-- $key=$value -->";
                            break;
                    }
                }
            } else {
                $html .= "$error"; // No message
            }
            $html .= $li->getEnd();
        }
        return $html;
    }
    
    /**
     * Returns the html for the control
     * @return String the complete html
     */
    function getHtml() {
        $html  = $this->html;
        
        // TODO FORMAT THE message
        // TODO control.highlight() and control.focus()
        
        $html .= $this->getStart();
        $html .= $this->getEnd();
        return $html;
    }
    
    /**
     * Display start html
     * <code>
     * Usage:
     *    Validator::start(); 
     * </code> 
     * @static
     */
    public static function start() {
        $html = new Validator();
        $html->addHtml($html->getStart());
    }

    /**
     * Display the error list as html
     * <code>
     * Usage:
     *    Validator::errorlist(); 
     * </code> 
     * @static
     */
    public static function errorlist() {
        $html = new Validator();
        $html->addHtml($html->getErrorList());
    }

    /**
     * Display end html
     * <code>
     * Usage:
     *    Validator::end(); 
     * </code> 
     * @static
     */
    public static function end() {
        $html = new Validator();
        $html->addHtml($html->getEnd());
    }

    /**
    * Display html
    * <code>
    * Usage:
    *    Validator::display(); 
    * </code> 
    * @static
    */
       public static function display() {
          $html = new Validator();
          $html->addHtml();
       }
}
?>
Validator.php

Validator, Sample code, tutorial

Validator, Sådan vises komponenten

Validator, PHP source code

Validator, HTML source code

Validator, Class methods

Validator, Object vars
