Added ActiveForm::mfield().

apps/advanced/backend/views/site/login.php

@@ -14,10 +14,13 @@ $this->params['breadcrumbs'][] = $this->title;
 
 <p>Please fill out the following fields to login:</p>
 
-<?php $form = ActiveForm::begin(array('options' => array('class' => 'form-horizontal'))); ?>
-	<?php echo $form->field($model, 'username')->textInput(); ?>
-	<?php echo $form->field($model, 'password')->passwordInput(); ?>
-	<?php echo $form->field($model, 'rememberMe')->checkbox(); ?>
+<?php $form = ActiveForm::begin(array(
+	'model' => $model,
+	'options' => array('class' => 'form-horizontal'),
+)); ?>
+	<?php echo $form->field('username')->textInput(); ?>
+	<?php echo $form->field('password')->passwordInput(); ?>
+	<?php echo $form->field('rememberMe')->checkbox(); ?>
 	<div class="form-actions">
 		<?php echo Html::submitButton('Login', null, null, array('class' => 'btn btn-primary')); ?>
 	</div>

apps/advanced/frontend/views/site/contact.php

@@ -24,14 +24,15 @@ $this->params['breadcrumbs'][] = $this->title;
 </p>
 
 <?php $form = ActiveForm::begin(array(
+	'model' => $model,
 	'options' => array('class' => 'form-horizontal'),
 	'fieldConfig' => array('inputOptions' => array('class' => 'input-xlarge')),
 )); ?>
-	<?php echo $form->field($model, 'name')->textInput(); ?>
-	<?php echo $form->field($model, 'email')->textInput(); ?>
-	<?php echo $form->field($model, 'subject')->textInput(); ?>
-	<?php echo $form->field($model, 'body')->textArea(array('rows' => 6)); ?>
-	<?php echo $form->field($model, 'verifyCode')->widget(Captcha::className(), array(
+	<?php echo $form->field('name')->textInput(); ?>
+	<?php echo $form->field('email')->textInput(); ?>
+	<?php echo $form->field('subject')->textInput(); ?>
+	<?php echo $form->field('body')->textArea(array('rows' => 6)); ?>
+	<?php echo $form->field('verifyCode')->widget(Captcha::className(), array(
 		'options' => array('class' => 'input-medium'),
 	)); ?>
 	<div class="form-actions">

apps/advanced/frontend/views/site/login.php

@@ -14,10 +14,13 @@ $this->params['breadcrumbs'][] = $this->title;
 
 <p>Please fill out the following fields to login:</p>
 
-<?php $form = ActiveForm::begin(array('options' => array('class' => 'form-horizontal'))); ?>
-	<?php echo $form->field($model, 'username')->textInput(); ?>
-	<?php echo $form->field($model, 'password')->passwordInput(); ?>
-	<?php echo $form->field($model, 'rememberMe')->checkbox(); ?>
+<?php $form = ActiveForm::begin(array(
+	'model' => $model,
+	'options' => array('class' => 'form-horizontal'),
+)); ?>
+	<?php echo $form->field('username')->textInput(); ?>
+	<?php echo $form->field('password')->passwordInput(); ?>
+	<?php echo $form->field('rememberMe')->checkbox(); ?>
 	<div class="form-actions">
 		<?php echo Html::submitButton('Login', null, null, array('class' => 'btn btn-primary')); ?>
 	</div>

apps/basic/views/site/contact.php

@@ -24,14 +24,15 @@ $this->params['breadcrumbs'][] = $this->title;
 </p>
 
 <?php $form = ActiveForm::begin(array(
+	'model' => $model,
 	'options' => array('class' => 'form-horizontal'),
 	'fieldConfig' => array('inputOptions' => array('class' => 'input-xlarge')),
 )); ?>
-	<?php echo $form->field($model, 'name')->textInput(); ?>
-	<?php echo $form->field($model, 'email')->textInput(); ?>
-	<?php echo $form->field($model, 'subject')->textInput(); ?>
-	<?php echo $form->field($model, 'body')->textArea(array('rows' => 6)); ?>
-	<?php echo $form->field($model, 'verifyCode')->widget(Captcha::className(), array(
+	<?php echo $form->field('name')->textInput(); ?>
+	<?php echo $form->field('email')->textInput(); ?>
+	<?php echo $form->field('subject')->textInput(); ?>
+	<?php echo $form->field('body')->textArea(array('rows' => 6)); ?>
+	<?php echo $form->field('verifyCode')->widget(Captcha::className(), array(
 		'options' => array('class' => 'input-medium'),
 	)); ?>
 	<div class="form-actions">

apps/basic/views/site/login.php

@@ -14,10 +14,13 @@ $this->params['breadcrumbs'][] = $this->title;
 
 <p>Please fill out the following fields to login:</p>
 
-<?php $form = ActiveForm::begin(array('options' => array('class' => 'form-horizontal'))); ?>
-	<?php echo $form->field($model, 'username')->textInput(); ?>
-	<?php echo $form->field($model, 'password')->passwordInput(); ?>
-	<?php echo $form->field($model, 'rememberMe')->checkbox(); ?>
+<?php $form = ActiveForm::begin(array(
+	'model' => $model,
+	'options' => array('class' => 'form-horizontal'),
+)); ?>
+	<?php echo $form->field('username')->textInput(); ?>
+	<?php echo $form->field('password')->passwordInput(); ?>
+	<?php echo $form->field('rememberMe')->checkbox(); ?>
 	<div class="form-actions">
 		<?php echo Html::submitButton('Login', null, null, array('class' => 'btn btn-primary')); ?>
 	</div>

docs/guide/upgrade-from-v1.md

@@ -327,9 +327,9 @@ is a container consisting of a label, an input, and an error message. It is repr
 as an `ActiveField` object. Using fields, you can build a form more cleanly than before:
 
 ```php
-<?php $form = yii\widgets\ActiveForm::begin(); ?>
-	<?php echo $form->field($model, 'username')->textInput(); ?>
-	<?php echo $form->field($model, 'password')->passwordInput(); ?>
+<?php $form = yii\widgets\ActiveForm::begin(array('model' => $model)); ?>
+	<?php echo $form->field('username')->textInput(); ?>
+	<?php echo $form->field('password')->passwordInput(); ?>
 	<div class="form-actions">
 		<?php echo Html::submitButton('Login'); ?>
 	</div>

framework/yii/widgets/ActiveForm.php

@@ -8,6 +8,7 @@
 namespace yii\widgets;
 
 use Yii;
+use yii\base\InvalidConfigException;
 use yii\base\Widget;
 use yii\base\Model;
 use yii\helpers\Html;
@@ -31,6 +32,12 @@ class ActiveForm extends Widget
 	 */
 	public $method = 'post';
 	/**
+	 * @var Model the model associated with this form. This property must be set if you call [[field()]]
+	 * to create input fields. If a form is associated with multiple models, this property is not needed
+	 * and you should use [[mfield()]] to create input fields.
+	 */
+	public $model;
+	/**
 	 * @var array the HTML attributes (name-value pairs) for the form tag.
 	 * The values will be HTML-encoded using [[Html::encode()]].
 	 * If a value is null, the corresponding attribute will not be rendered.
@@ -208,17 +215,50 @@ class ActiveForm extends Widget
 	}
 
 	/**
-	 * Generates a form field.
+	 * Generates a form field using [[model]] and the specified attribute.
+	 *
 	 * A form field is associated with a model and an attribute. It contains a label, an input and an error message
-	 * and use them to interact with end users to collect their inputs for the attribute.
+	 * and uses them to interact with end users to collect their input for the attribute.
+	 *
+	 * This method is mainly used for a form with a single model.
+	 *
+	 * @param string $attribute the attribute name or expression. See [[Html::getAttributeName()]] for the format
+	 * about attribute expression.
+	 * @param array $options the additional configurations for the field object
+	 * @return ActiveField the created ActiveField object
+	 * @throws InvalidConfigException if [[model]] is not specified
+	 * @see fieldConfig
+	 * @see mfield
+	 */
+	public function field($attribute, $options = array())
+	{
+		if (!$this->model instanceof Model) {
+			throw new InvalidConfigException('The "model" property must be set.');
+		}
+		return Yii::createObject(array_merge($this->fieldConfig, $options, array(
+			'model' => $this->model,
+			'attribute' => $attribute,
+			'form' => $this,
+		)));
+	}
+
+	/**
+	 * Generates a form field using the specified model and attribute.
+	 *
+	 * This method differs from [[field()]] in that the model is passed as a parameter rather than obtained
+	 * from [[model]].
+	 *
+	 * This method is mainly used for a form with multiple models.
+	 *
 	 * @param Model $model the data model
 	 * @param string $attribute the attribute name or expression. See [[Html::getAttributeName()]] for the format
 	 * about attribute expression.
 	 * @param array $options the additional configurations for the field object
 	 * @return ActiveField the created ActiveField object
 	 * @see fieldConfig
+	 * @see field
 	 */
-	public function field($model, $attribute, $options = array())
+	public function mfield($model, $attribute, $options = array())
 	{
 		return Yii::createObject(array_merge($this->fieldConfig, $options, array(
 			'model' => $model,