Form API - часть 1. Базовые понятия и создание простейшей формы.

Сегодня приступаем к изучению одной из важнейших составляющих Drupal – Form API. Что же такое Form API? Form API – это некий набор функций Drupal, которые позволяют нам с вами, в данном случае я имею ввиду разработчиков, создавать собственные формы, как присуще всем формам со своими функциями валидации и обработки формы.

В первой части мы с вами построим простейшую форму на основе Form API с двумя текстовыми полями и кнопкой отправки формы. Естественно, для дальнейшего прочтения статьи вам необходимо знание PHP, без него вы вряд ли, что поймете.

Итак, давайте сразу разберемся, что нам может понадобиться для создания своей формы? В первую очередь, нам необходима страница, где мы будем выводить элементы формы и собственно сама форма.

Приступим, как вы наверное уже знаете организация страниц в Drupal осуществляется с помощью

Поэтому для начала создадим страницу для вывода нашей формы, естественно все действия производим в своем модуле (Как создать свой модуль? ). В данной статье модуль будет называться как myform:

name = Myform
description = Form Api
core = 7.x
package = Other

<?php
/**
 * implements hook_menu()
 */
function myform_menu(){
    $items = array();
    $items['myform'] = array(
 
        'title' => 'Form API',
        'page callback' => 'myform_page',
        'access callback' => TRUE
 
    );
 
    return $items;
}
 
function myform_page() {
    return t('Страница для формы');
}

Далее активируем модуль и видим, что у нас появилась новая страница

Теперь приступим к созданию формы.За организацию формы отвечает :

Поэтому изменим callback для нашей страницы на

Далее в этой функции нам необходимо описать элементы формы, в данном случае мы будем описывать два текстовых поля и кнопку отправки формы.

Хочу заметить, что при описании элементов формы каждый из элементов должен содержать обязательные значения, количество обязательных значений зависит от типа элемента. Тип элемента формы является обязательным для всех элементов формы.

Теперь наш модуль выглядит так (не забудьте после изменения названия функций в своем модуле - чистить кэш drupal):

<?php
/**
 * implements hook_menu()
 */
function myform_menu(){
    $items = array();
    $items['myform'] = array(
      'title' => 'Form API',
      'page callback' => 'myform_form', // изменили callback на myform_form
      'access callback' => TRUE
    );
 
    return $items;
}
 
/**
 * Callback myform
 */
function myform_form() {
 
    // Описали первое текстовое поле
    $form['onetextfield'] = array(
      '#type' => 'textfield',                   // тип поля
      '#title' => t('первое текстовое поле'),   // заголовок поля
    );
 
    // Описали второе текстовое поле
    $form['twotextfield'] = array(
      '#type' => 'textfield',                   // тип поля
      '#title' => t('второе текстовое поле'),   // заголовок поля
    );
 
    // Описали кнопку отправки форму
    $form['submit'] = array(
      '#type' => 'submit',                      // тип поля
      '#value' => t('отправить форму'),         // текст кнопки формы
    );
    return $form;
}

Смотрим результат

Видим, что мы добились того, что и было необходимо, мы создали два текстовых поля и кнопку отправки формы и заметьте без единого написания кода HTML.

Итак, из первой части вы должны понять принцип построения формы, а так же как описывать простейшие элементы формы. В следующих уроках, мы с вами рассмотрим функции валидации и обработки формы, а так же будем рассматривать все имеющиеся элементы формы, а пока на этом все.