* @since 2.0 */ class ActiveForm extends Widget { /** * @param array|string $action the form action URL. This parameter will be processed by [[\yii\helpers\Html::url()]]. */ public $action = ''; /** * @var string the form submission method. This should be either 'post' or 'get'. * Defaults to 'post'. */ public $method = 'post'; public $options = array(); public $fieldOptions = array('tag' => 'div', 'class' => 'yii-field'); public $fieldTemplate = "{label}\n{input}\n{error}"; public $autoFieldCssClass = true; public $errorOptions = array('tag' => 'span', 'class' => 'yii-error-message'); public $labelOptions = array('class' => 'control-label'); /** * @var string the default CSS class for the error summary container. * @see errorSummary() */ public $errorSummaryCssClass = 'yii-error-summary'; /** * @var string the default CSS class that indicates an input is required. */ public $requiredCssClass = 'required'; /** * @var string the default CSS class that indicates an input has error. */ public $errorCssClass = 'error'; /** * @var string the default CSS class that indicates an input validated successfully. */ public $successCssClass = 'success'; /** * @var string the default CSS class that indicates an input is currently being validated. */ public $validatingCssClass = 'validating'; /** * @var boolean whether to enable client-side data validation. Defaults to false. * When this property is set true, client-side validation will be performed by validators * that support it (see {@link CValidator::enableClientValidation} and {@link CValidator::clientValidateAttribute}). */ public $enableClientValidation = false; public $fieldClass = 'yii\widgets\ActiveField'; /** * Initializes the widget. * This renders the form open tag. */ public function init() { echo Html::beginForm($this->action, $this->method, $this->options); } /** * Runs the widget. * This registers the necessary javascript code and renders the form close tag. */ public function run() { echo Html::endForm(); } /** * @param Model|Model[] $models * @param array $options * @return string */ public function errorSummary($models, $options = array()) { if (!is_array($models)) { $models = array($models); } $showAll = !empty($options['showAll']); $lines = array(); /** @var $model Model */ foreach ($models as $model) { if ($showAll) { foreach ($model->getErrors() as $errors) { $lines = array_merge($lines, $errors); } } else { $lines = array_merge($lines, $model->getFirstErrors()); } } $header = isset($options['header']) ? $options['header'] : '
' . Yii::t('yii|Please fix the following errors:') . '
'; $footer = isset($options['footer']) ? $options['footer'] : ''; $tag = isset($options['tag']) ? $options['tag'] : 'div'; unset($options['showAll'], $options['header'], $options['footer'], $options['container']); if (!isset($options['class'])) { $options['class'] = $this->errorSummaryCssClass; } else { $options['class'] .= ' ' . $this->errorSummaryCssClass; } if ($lines !== array()) { $content = "