Overview

Namespaces

  • MvcCore
    • Ext
      • Auth
        • Virtual
      • Debug
        • Tracy
      • Form
        • Core
        • Validators
      • Request
      • Router
        • Lang
      • View
        • Helpers
  • None

Classes

  • MvcCore
  • MvcCore\Config
  • MvcCore\Controller
  • MvcCore\Debug
  • MvcCore\Ext\Auth
  • MvcCore\Ext\Auth\Controller
  • MvcCore\Ext\Auth\SignInForm
  • MvcCore\Ext\Auth\SignOutForm
  • MvcCore\Ext\Auth\User
  • MvcCore\Ext\Auth\Virtual\Controller
  • MvcCore\Ext\Auth\Virtual\Form
  • MvcCore\Ext\Auth\Virtual\User
  • MvcCore\Ext\Debug\Tracy
  • MvcCore\Ext\Debug\Tracy\AuthPanel
  • MvcCore\Ext\Debug\Tracy\IncludePanel
  • MvcCore\Ext\Debug\Tracy\MvcCorePanel
  • MvcCore\Ext\Debug\Tracy\RoutingPanel
  • MvcCore\Ext\Debug\Tracy\SessionPanel
  • MvcCore\Ext\Form
  • MvcCore\Ext\Form\Button
  • MvcCore\Ext\Form\Checkbox
  • MvcCore\Ext\Form\CheckboxGroup
  • MvcCore\Ext\Form\Core\Base
  • MvcCore\Ext\Form\Core\Configuration
  • MvcCore\Ext\Form\Core\Field
  • MvcCore\Ext\Form\Core\FieldGroup
  • MvcCore\Ext\Form\Core\Helpers
  • MvcCore\Ext\Form\Core\Validator
  • MvcCore\Ext\Form\Core\View
  • MvcCore\Ext\Form\CountrySelect
  • MvcCore\Ext\Form\Date
  • MvcCore\Ext\Form\DateTime
  • MvcCore\Ext\Form\Email
  • MvcCore\Ext\Form\Hidden
  • MvcCore\Ext\Form\NoType
  • MvcCore\Ext\Form\Number
  • MvcCore\Ext\Form\Password
  • MvcCore\Ext\Form\RadioGroup
  • MvcCore\Ext\Form\Range
  • MvcCore\Ext\Form\ResetButton
  • MvcCore\Ext\Form\ResetInput
  • MvcCore\Ext\Form\Select
  • MvcCore\Ext\Form\SubmitButton
  • MvcCore\Ext\Form\SubmitInput
  • MvcCore\Ext\Form\Text
  • MvcCore\Ext\Form\Textarea
  • MvcCore\Ext\Form\Time
  • MvcCore\Ext\Form\Validators\CompanyId
  • MvcCore\Ext\Form\Validators\CompanyVatId
  • MvcCore\Ext\Form\Validators\Date
  • MvcCore\Ext\Form\Validators\Email
  • MvcCore\Ext\Form\Validators\FloatVal
  • MvcCore\Ext\Form\Validators\Integer
  • MvcCore\Ext\Form\Validators\Maxlength
  • MvcCore\Ext\Form\Validators\MaxSelectedOptions
  • MvcCore\Ext\Form\Validators\MinSelectedOptions
  • MvcCore\Ext\Form\Validators\NumberField
  • MvcCore\Ext\Form\Validators\Pattern
  • MvcCore\Ext\Form\Validators\Phone
  • MvcCore\Ext\Form\Validators\RangeField
  • MvcCore\Ext\Form\Validators\SafeString
  • MvcCore\Ext\Form\Validators\Time
  • MvcCore\Ext\Form\Validators\Url
  • MvcCore\Ext\Form\Validators\ValueInOptions
  • MvcCore\Ext\Form\Validators\ZipCode
  • MvcCore\Ext\Request\ApacheDpi
  • MvcCore\Ext\Request\Cli
  • MvcCore\Ext\Router\Lang
  • MvcCore\Ext\Router\Lang\Route
  • MvcCore\Ext\Router\Media
  • MvcCore\Ext\Router\MediaSiteKey
  • MvcCore\Ext\View\Helpers\Assets
  • MvcCore\Ext\View\Helpers\Css
  • MvcCore\Ext\View\Helpers\Js
  • MvcCore\Ext\View\Helpers\LineBreaks
  • MvcCore\Model
  • MvcCore\Request
  • MvcCore\Response
  • MvcCore\Route
  • MvcCore\Router
  • MvcCore\Session
  • MvcCore\Tool
  • MvcCore\View

Exceptions

  • MvcCore\Ext\Form\Core\Exception
  • Overview
  • Namespace
  • Class
  • Tree
  1:   2:   3:   4:   5:   6:   7:   8:   9:  10:  11:  12:  13:  14:  15:  16:  17:  18:  19:  20:  21:  22:  23:  24:  25:  26:  27:  28:  29:  30:  31:  32:  33:  34:  35:  36:  37:  38:  39:  40:  41:  42:  43:  44:  45:  46:  47:  48:  49:  50:  51:  52:  53:  54:  55:  56:  57:  58:  59:  60:  61:  62:  63:  64:  65:  66:  67:  68:  69:  70:  71:  72:  73:  74:  75:  76:  77:  78:  79:  80:  81:  82:  83:  84:  85:  86:  87:  88:  89:  90:  91:  92:  93:  94:  95:  96:  97:  98:  99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: 137: 138: 139: 140: 141: 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: 153: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: 166: 167: 168: 169: 170: 171: 172: 173: 174: 175: 176: 177: 178: 179: 180: 181: 182: 183: 184: 185: 186: 187: 188: 189: 190: 191: 192: 193: 194: 195: 196: 197: 198: 199: 
<?php

/**
 * MvcCore
 *
 * This source file is subject to the BSD 3 License
 * For the full copyright and license information, please view 
 * the LICENSE.md file that are distributed with this source code.
 *
 * @copyright   Copyright (c) 2016 Tom FlĂ­dr (https://github.com/mvccore/mvccore)
 * @license     https://mvccore.github.io/docs/mvccore/4.0.0/LICENCE.md
 */

namespace MvcCore\Ext\Form\Core;

//require_once('MvcCore/View.php');

//require_once('Helpers.php');
//require_once('Configuration.php');

use \MvcCore\Ext\Form;

class View extends \MvcCore\View
{
    /**
     * @var \MvcCore\Ext\Form
     */
    public $Form = null;
    /**
     * @var \MvcCore\View|mixed
     */
    public $View = null;

    /**
     * Form View Constructor, extending \MvcCore\View
     * @param \MvcCore\Ext\Form $form 
     */
    public function __construct (\MvcCore\Ext\Form & $form) {
        $ctrl = & $form->Controller;
        if (class_exists('\MvcCore\Controller') && $ctrl instanceof \MvcCore\Controller) {
            parent::__construct($ctrl);
        } else {
            $this->Controller = & $ctrl;
        }
        $this->Form = & $form;
        include_once('Helpers.php');
        $this->View = Helpers::GetControllerView($ctrl);
    }
    /**
     * Call public field method if exists under called name or try to call any parent view helper.
     * @param string $method 
     * @param mixed  $arguments 
     * @return mixed
     */
    public function __call ($method, $arguments) {
        if (isset($this->Field) && method_exists($this->Field, $method)) {
            return call_user_func_array(array($this->Field, $method), $arguments);
        } else {
            return parent::__call($method, $arguments);
        }
    }
    /**
     * Render configured form template.
     * @return string
     */
    public function RenderTemplate () {
        return $this->Render($this->Form->TemplateTypePath, $this->Form->TemplatePath);
    }
    /**
     * Render form naturaly by cycles inside php scripts.
     * All form fields will be rendered inside empty <div> elements.
     * @return string
     */
    public function RenderNaturally () {
        return $this->RenderBegin() . $this->RenderErrors() . $this->RenderContent() . $this->RenderEnd();
    }
    /**
     * Render form begin.
     * Render opening <form> tag and hidden input with csrf tokens.
     * @return string
     */
    public function RenderBegin () {
        $result = "<form";
        $attrs = array();
        $form = & $this->Form;
        $formProperties = array('Id', 'Action', 'Method', 'Enctype');
        foreach ($formProperties as $property) {
            if ($form->$property) $attrs[strtolower($property)] = $form->$property;
        }
        if ($form->CssClass) $attrs['class'] = $form->CssClass;
        foreach ($form->Attributes as $key => $value) {
            if (!in_array($key, $formProperties)) $attrs[$key] = $value;
        }
        $attrsStr = self::RenderAttrs($attrs);
        if ($attrsStr) $result .= ' ' . $attrsStr;
        $result .= '>';
        $result .= $this->RenderCsrf();
        return $result;
    }
    /**
     * Render hidden input with CSRF tokens.
     * This method is not necessary to call, it's 
     * called internaly by $form->View->RenderBegin();
     * @return string
     */
    public function RenderCsrf () {
        list ($name, $value) = $this->Form->SetUpCsrf();
        return '<input type="hidden" name="'.$name.'" value="'.$value.'" />';
    }
    /**
     * Return current cross site request forgery hidden
     * input name and it's value as stdClass.
     * Result stdClass elements has keys 'name' and 'value'.
     * @return \stdClass
     */
    public function GetCsrf () {
        return $this->Form->GetCsrf();
    }
    /**
     * Render form errors.
     * If form is configured to render all errors together at form beginning,
     * this function completes all form errors into div.errors with div.error elements
     * inside containing each single errors message.
     * @return string
     */
    public function RenderErrors () {
        $result = "";
        include_once('Configuration.php');
        if ($this->Form->Errors && $this->Form->ErrorsRenderMode == Configuration::ERROR_RENDER_MODE_ALL_TOGETHER) {
            $result .= '<div class="errors">';
            foreach ($this->Form->Errors as & $errorMessageAndFieldName) {
                $errorMessage = $errorMessageAndFieldName[0];
                $fieldName = isset($errorMessageAndFieldName[1]) ? $errorMessageAndFieldName[1] : '' ;
                $result .= '<div class="error ' . $fieldName . '">'.$errorMessage.'</div>';
            }
            $result .= '</div>';
        }
        return $result;
    }
    /**
     * Render form content.
     * Go through all $form->Fields and call $field->Render(); on every field
     * and put it into an empty <div> element. Render each field in full possible
     * way - naturaly by label configuration with possible errors configured beside
     * or with custom field template.
     * @return string
     */
    public function RenderContent () {
        $result = "";
        $fieldRendered = "";
        foreach ($this->Form->Fields as & $field) {
            $fieldRendered = $field->Render();
            include_once(__DIR__ . '/../Hidden.php');
            if (!($field instanceof Form\Hidden)) {
                $fieldRendered = "<div>".$fieldRendered."</div>";
            }
            $result .= $fieldRendered;
        }
        return $result;
    }
    /**
     * Render form end.
     * Render html closing </form> tag and supporting javascript and css files
     * if is form not using external js/css renderers.
     * @return string
     */
    public function RenderEnd () {
        $result = "</form>";
        if ($this->Js) $result .= $this->Form->RenderJs();
        if ($this->Css) $result .= $this->Form->RenderCss();
        return $result;
    }
    /**
     * Format string function.
     * @param string $str template with replacements like {0}, {1}, {anyStringKey}...
     * @param array $args each value under it's index is replaced as 
     *                    string representation by replacement in form {arrayKey}
     * @return string
     */
    public static function Format ($str = '', array $args = array()) {
        foreach ($args as $key => $value) {
            $str = str_replace('{'.$key.'}', (string)$value, $str);
        }
        return $str;
    }
    /**
     * Render content of html tag attributes by key/value array.
     * @param array $atrributes 
     * @return string
     */
    public static function RenderAttrs (array $atrributes = array()) {
        $result = array();
        foreach ($atrributes as $attrName => $attrValue) {
            $result[] = $attrName.'="'.$attrValue.'"';
        }
        return implode(' ', $result);
    }
}
MvcCore API documentation generated by ApiGen