Error202
/
yii2
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Browse Source

Added ActiveField::widget().

tags/2.0.0-alpha
Qiang Xue 11 years ago
parent
23611127dd
commit
aadcb59c8c
1 changed files with 49 additions and 23 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 72
      framework/yii/widgets/ActiveField.php

72
framework/yii/widgets/ActiveField.php
Unescape View File

@ -6,6 +6,7 @@
*/
namespace yii\widgets;
use Yii;
use yii\base\Component;
use yii\db\ActiveRecord;
use yii\helpers\Html;
@ -101,6 +102,11 @@ class ActiveField extends Component
*/
public $selectors;
/**
* Renders the opening tag of the field container.
* @return string the rendering result.
*/
public function begin()
{
$options = $this->getClientOptions();
@ -124,11 +130,19 @@ class ActiveField extends Component
return Html::beginTag($this->tag, $options);
}
/**
* Renders the closing tag of the field container.
* @return string the rendering result.
*/
public function end()
{
return Html::endTag($this->tag);
}
/**
* Returns the JS options for the field.
* @return array the JS options
*/
protected function getClientOptions()
{
$enableClientValidation = $this->enableClientValidation || $this->enableClientValidation === null && $this->form->enableClientValidation;
@ -237,7 +251,7 @@ class ActiveField extends Component
}
/**
* Generates an input tag for the given model attribute.
* Renders a field containing an input field.
* @param string $type the input type (e.g. 'text', 'password')
* @param array $options the tag options in terms of name-value pairs. These will be rendered as
* the attributes of the resulting tag. The values will be HTML-encoded using [[encode()]].
@ -250,12 +264,12 @@ class ActiveField extends Component
}
/**
* Generates a text input tag for the given model attribute.
* Renders a field containing a text input.
* This method will generate the "name" and "value" tag attributes automatically for the model attribute
* unless they are explicitly specified in `$options`.
* @param array $options the tag options in terms of name-value pairs. These will be rendered as
* the attributes of the resulting tag. The values will be HTML-encoded using [[encode()]].
* @return string the generated input tag
* @return string the rendering result
*/
public function textInput($options = array())
{
@ -264,12 +278,12 @@ class ActiveField extends Component
}
/**
* Generates a hidden input tag for the given model attribute.
* Renders a field containing a hidden input.
* This method will generate the "name" and "value" tag attributes automatically for the model attribute
* unless they are explicitly specified in `$options`.
* @param array $options the tag options in terms of name-value pairs. These will be rendered as
* the attributes of the resulting tag. The values will be HTML-encoded using [[encode()]].
* @return string the generated input tag
* @return string the rendering result
*/
public function hiddenInput($options = array())
{
@ -278,12 +292,12 @@ class ActiveField extends Component
}
/**
* Generates a password input tag for the given model attribute.
* Renders a field containing a password input.
* This method will generate the "name" and "value" tag attributes automatically for the model attribute
* unless they are explicitly specified in `$options`.
* @param array $options the tag options in terms of name-value pairs. These will be rendered as
* the attributes of the resulting tag. The values will be HTML-encoded using [[encode()]].
* @return string the generated input tag
* @return string the rendering result
*/
public function passwordInput($options = array())
{
@ -292,12 +306,12 @@ class ActiveField extends Component
}
/**
* Generates a file input tag for the given model attribute.
* Renders a field containing a file input.
* This method will generate the "name" and "value" tag attributes automatically for the model attribute
* unless they are explicitly specified in `$options`.
* @param array $options the tag options in terms of name-value pairs. These will be rendered as
* the attributes of the resulting tag. The values will be HTML-encoded using [[encode()]].
* @return string the generated input tag
* @return string the rendering result
*/
public function fileInput($options = array())
{
@ -306,11 +320,11 @@ class ActiveField extends Component
}
/**
* Generates a textarea tag for the given model attribute.
* Renders a field containing a text area.
* The model attribute value will be used as the content in the textarea.
* @param array $options the tag options in terms of name-value pairs. These will be rendered as
* the attributes of the resulting tag. The values will be HTML-encoded using [[encode()]].
* @return string the generated textarea tag
* @return string the rendering result
*/
public function textarea($options = array())
{
@ -319,7 +333,7 @@ class ActiveField extends Component
}
/**
* Generates a radio button tag for the given model attribute.
* Renders a field containing a radio button.
* This method will generate the "name" tag attribute automatically unless it is explicitly specified in `$options`.
* This method will generate the "checked" tag attribute according to the model attribute value.
* @param array $options the tag options in terms of name-value pairs. The following options are specially handled:
@ -334,7 +348,7 @@ class ActiveField extends Component
* @param boolean $enclosedByLabel whether to enclose the radio within the label.
* If true, the method will still use [[template]] to layout the checkbox and the error message
* except that the radio is enclosed by the label tag.
* @return string the generated radio button tag
* @return string the rendering result
*/
public function radio($options = array(), $enclosedByLabel = true)
{
@ -358,7 +372,7 @@ class ActiveField extends Component
}
/**
* Generates a checkbox tag for the given model attribute.
* Renders a field containing a checkbox.
* This method will generate the "name" tag attribute automatically unless it is explicitly specified in `$options`.
* This method will generate the "checked" tag attribute according to the model attribute value.
* @param array $options the tag options in terms of name-value pairs. The following options are specially handled:
@ -373,7 +387,7 @@ class ActiveField extends Component
* @param boolean $enclosedByLabel whether to enclose the checkbox within the label.
* If true, the method will still use [[template]] to layout the checkbox and the error message
* except that the checkbox is enclosed by the label tag.
* @return string the generated checkbox tag
* @return string the rendering result
*/
public function checkbox($options = array(), $enclosedByLabel = true)
{
@ -397,7 +411,7 @@ class ActiveField extends Component
}
/**
* Generates a drop-down list for the given model attribute.
* Renders a field containing a drop-down list.
* The selection of the drop-down list is taken from the value of the model attribute.
* @param array $items the option data items. The array keys are option values, and the array values
* are the corresponding option labels. The array can also be nested (i.e. some array values are arrays too).
@ -426,7 +440,7 @@ class ActiveField extends Component
* The rest of the options will be rendered as the attributes of the resulting tag. The values will
* be HTML-encoded using [[encode()]]. If a value is null, the corresponding attribute will not be rendered.
*
* @return string the generated drop-down list tag
* @return string the rendering result
*/
public function dropDownList($items, $options = array())
{
@ -435,7 +449,7 @@ class ActiveField extends Component
}
/**
* Generates a list box.
* Renders a field containing a list box.
* The selection of the list box is taken from the value of the model attribute.
* @param array $items the option data items. The array keys are option values, and the array values
* are the corresponding option labels. The array can also be nested (i.e. some array values are arrays too).
@ -467,7 +481,7 @@ class ActiveField extends Component
* The rest of the options will be rendered as the attributes of the resulting tag. The values will
* be HTML-encoded using [[encode()]]. If a value is null, the corresponding attribute will not be rendered.
*
* @return string the generated list box tag
* @return string the rendering result
*/
public function listBox($items, $options = array())
{
@ -476,7 +490,7 @@ class ActiveField extends Component
}
/**
* Generates a list of checkboxes.
* Renders a field containing a list of checkboxes.
* A checkbox list allows multiple selection, like [[listBox()]].
* As a result, the corresponding submitted value is an array.
* The selection of the checkbox list is taken from the value of the model attribute.
@ -498,7 +512,7 @@ class ActiveField extends Component
* where $index is the zero-based index of the checkbox in the whole list; $label
* is the label for the checkbox; and $name, $value and $checked represent the name,
* value and the checked status of the checkbox input.
* @return string the generated checkbox list
* @return string the rendering result
*/
public function checkboxList($items, $options = array())
{
@ -510,7 +524,7 @@ class ActiveField extends Component
}
/**
* Generates a list of radio buttons.
* Renders a field containing a list of radio buttons.
* A radio button list is like a checkbox list, except that it only allows single selection.
* The selection of the radio buttons is taken from the value of the model attribute.
* @param array $items the data item used to generate the radio buttons.
@ -531,7 +545,7 @@ class ActiveField extends Component
* where $index is the zero-based index of the radio button in the whole list; $label
* is the label for the radio button; and $name, $value and $checked represent the name,
* value and the checked status of the radio button input.
* @return string the generated radio button list
* @return string the rendering result
*/
public function radioList($items, $options = array())
{
@ -541,4 +555,16 @@ class ActiveField extends Component
. '</div>'
);
}
/**
* Renders a field containing a widget.
* @param string $class the widget class name
* @param array $config name-value pairs that will be used to initialize the widget
* @return string the rendering result
*/
public function widget($class, $config = array())
{
/** @var \yii\base\Widget $class */
return $this->render($class::widget($config));
}
}

Write Preview
Loading…
Cancel
Save