yii2/docs/guide-ru/input-forms.md

Создание форм

<<<<<<< HEAD Основной способ использования форм в Yii является использоваение yii\widgets\ActiveForm. Этот подход должен быть применён, когда форма основана на модели. Кроме того, имеются дополнительные методы в yii\helpers\Html, которые используются для добавления кнопок и текстовых подсказок к любой форме.

Форме, которая отображается на стороне клиента, в большинстве случаев соответствует модели. Модель в свою очередь проверяет данные из элементов формы на сервере (посмотрите раздел Валидация для более подробных сведений). Когда создаётся форма, основанная на модели, необходимо определить, что же является моделью. Модель может основываться на классе Active Record, который описывает некоторые данные из базы данных, или модель может основываться на базовом классе Model (происходит от yii\base\Model), который позволяет использовать произвольный набор элементов формы, например форма входа.

Основной способ использования форм в Yii является использование yii\widgets\ActiveForm. Этот подход должен быть применён, когда форма основана на модели. Кроме того, имеются дополнительные методы в yii\helpers\Html, которые используются для добавления кнопок и текстовых подсказок к любой форме.

Форма, которая отображается на стороне клиента, в большинстве случаев, соответствует модели. Модель, в свою очередь, проверяет данные из элементов формы на сервере (посмотрите раздел Валидация для более подробных сведений). Когда создаётся форма, основанная на модели, необходимо определить, что же является моделью. Модель может основываться на классе Active Record, который описывает некоторые данные из базы данных, или модель может основываться на базовом классе Model (происходит от yii\base\Model), который позволяет использовать произвольный набор элементов формы, например, форма входа.

master

В следующем примере показано, как создать модель формы, основанной на базовом классе Model:

<?php

class LoginForm extends \yii\base\Model
{
    public $username;
    public $password;

    public function rules()
    {
        return [
            // тут определяются правила валидации
        ];
    }
}

<<<<<<< HEAD В контроллере, будем передать экземпляр этой модели в вид, для yii\widgets\ActiveForm виджета, который генерирует форму.

В контроллере будем передавать экземпляр этой модели в представление для виджета yii\widgets\ActiveForm, который генерирует форму.

master

<?php
use yii\helpers\Html;
use yii\widgets\ActiveForm;

$form = ActiveForm::begin([
    'id' => 'login-form',
    'options' => ['class' => 'form-horizontal'],
]) ?>
    <?= $form->field($model, 'username') ?>
    <?= $form->field($model, 'password')->passwordInput() ?>

    <div class="form-group">
        <div class="col-lg-offset-1 col-lg-11">
            <?= Html::submitButton('Вход', ['class' => 'btn btn-primary']) ?>
        </div>
    </div>
<?php ActiveForm::end() ?>

В вышеизложенном коде, yii\widgets\ActiveForm::begin() не только создаёт экземпляр формы, но также и знаменует её начало. Весь контент, расположенный между yii\widgets\ActiveForm::begin() и yii\widgets\ActiveForm::end(), будет завёрнут в HTML <form> тег. Вы можете настроить некоторые настройки виджета через передачу массива в его begin метод, также как и в любом другом виджете. В этом случае, дополнительный CSS класс и идентификатор ID будет прикреплён к открывающемуся тегу <form>. Для просмотра всех доступных настроек, пожалуйста обратитесь к API документации yii\widgets\ActiveForm.

<<<<<<< HEAD Для создания в форме элемента с меткой и любой применимой Javascript валадиацией, вызывается yii\widgets\ActiveForm::field(),

Для создания в форме элемента с меткой и любой применимой Javascript валидацией, вызывается yii\widgets\ActiveForm::field(),

master который возвращает экземпляр yii\widgets\ActiveField. Когда этот метод вызывается непосредственно, то результатом будет текстовый элемент (input type="text"). Для того, чтобы настроить элемент, можно вызвать одни за одним дополнительные методы yii\widgets\ActiveField:

// элемент формы password
<?= $form->field($model, 'password')->passwordInput() ?>
// добавлена подсказка hint и настроена метка label
<?= $form->field($model, 'username')->textInput()->hint('Пожалуйста, введите имя')->label('Имя') ?>
// создание HTML5 email элемента
<?= $form->field($model, 'email')->input('email') ?>

Впоследствии будет созданы <label>, <input> и другие теги в соответствии с yii\widgets\ActiveField::$template, который определён в элементе. Имя элемента формы определяется автоматически из моделей yii\base\Model::formName() и их атрибутов. Например, имя элемента для атрибута username в коде, приведённом выше, будет LoginForm[username]. <<<<<<< HEAD Это правило наименование будет учитываться на стороне сервера при получении массива результатов $_POST['LoginForm'] для всех элементов формы входа (Login Form).

Специфический атрибут модели может быть задан через более сложный способ. Например, при загрузки файлов или выборе

Это правило именования будет учитываться на стороне сервера при получении массива результатов $_POST['LoginForm'] для всех элементов формы входа (Login Form).

Специфический атрибут модели может быть задан через более сложный способ. Например, при загрузке файлов или выборе

master нескольких значений из списка, в качестве значений атрибуту модели нужно передать массив, для этого к имени можно добавить []:

// поддерживает загрузку нескольких файлов:
echo $form->field($model, 'uploadFile[]')->fileInput(['multiple'=>'multiple']);

// поддерживает выбор нескольких значений:
echo $form->field($model, 'items[]')->checkboxList(['a' => 'Item A', 'b' => 'Item B', 'c' => 'Item C']);

<<<<<<< HEAD Дополнительные HTML элементы могут быть добавлены к форме используя обычный HTML или методы из класса помощника yii\helpers\Html, как это было сделано с помощью yii\helpers\Html::submitButton() в примере, что выше.

Подсказка: Если вы использует Twitter Bootstrap CSS в своём приложении, то воспользуйтесь yii\bootstrap\ActiveForm вместо yii\widgets\ActiveForm. Он добавит к ActiveForm дополнительные стили, которые сработают в рамках bootstrap CSS.

Подсказка: для добавления "звёздочки" к обязательным элементам формы воспользуйтесь следующим CSS:

div.required label:after {

======= Имена элементов форм следует выбирать, учитывая, что могут возникнуть конфликты. Подробнее об этом в документации jQuery:

Имена и идентификаторы форм и их элементов не должны совпадать с элементами форм, такими как submit, length, или method. Конфликты имен могут вызывать трудно диагностируемые ошибки. Подробнее о способах избегания подобных проблем смотрите DOMLint.

Дополнительные HTML элементы могут быть добавлены к форме используя обычный HTML или методы из класса помощника yii\helpers\Html, как это было сделано с помощью yii\helpers\Html::submitButton() в примере, что выше.

Tip: Если вы использует Twitter Bootstrap CSS в своём приложении, то воспользуйтесь yii\bootstrap\ActiveForm вместо yii\widgets\ActiveForm. Он добавит к ActiveForm дополнительные стили, которые сработают в рамках bootstrap CSS.

Tip: для добавления "звёздочки" к обязательным элементам формы воспользуйтесь следующим CSS:

div.required label.control-label:after {
>>>>>> master
    content: " *";
    color: red;
}

<<<<<<< HEAD Следующая глава Validating Input описывает валидацию отправленной формы как на стороне сервера,

Создание выпадающего списка

Для создания выпадающего списка можно использовать метод ActiveForm yii\widgets\ActiveField::dropDownList():

use app\models\ProductCategory;
use yii\helpers\ArrayHelper;

/* @var $this yii\web\View */
/* @var $form yii\widgets\ActiveForm */
/* @var $model app\models\Product */

echo $form->field($model, 'product_category')->dropdownList(
    ProductCategory::find()->select(['category_name', 'id'])->indexBy('id')->column(),
    ['prompt'=>'Select Category']
);

Текущее значение поля модели будет автоматически выбрано в списке.

Еще по теме

Следующая глава Валидация описывает валидацию отправленной формы как на стороне сервера,

master так и на стороне клиента.

Если вы хотите более подробно изучить информацию по использованию форм, то обратитесь к главам:

<<<<<<< HEAD

• Collecting tabular input for collecting data for multiple models of the same kind.
• Complex Forms with Multiple Models for handling multiple different models in the same form.
• Загрузка файлов - как использовать формы для загрузки файлов. =======
• Табличный ввод - получение данных нескольких моделей одного вида.
• Работа с несколькими моделями - обработка нескольких разных моделей в рамках одной формы.
• Загрузка файлов - использование форм для загрузки файлов.

master