Drupal → Создание табличной формы

Пример создания таблицы со списком материалов, в которой можно редактировать заголовки и устанавливать статус ноды:

Небольшая вводная информация — при создании любых табличных форм, я обычно применяю принцип прогрессивного улучшения. Т.е. первым делом создаю форму как если бы я ничего не знал о темизации, но форма при этом должна быть полностью рабочая и понятно выглядеть. Например вот так выглядит наша табличная форма без использования темизации:

Ну а вторым шагом, с помощью темизации, придаю ей необходимый вид:

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

Итак, код с комментариями:

/**
 * Form builder.
 */
function modulename_massedit_form($form, &$form_state) {
  $form['nodes'] = array(
    '#tree' => TRUE,
    '#theme' => 'table_form', // Функция, с помощью которой мы будем придавать форме табличный вид
  );

  $nodes = db_query("SELECT nid, title, created, status FROM {node}");

  foreach ($nodes as $node) {
    $form['nodes'][$node->nid]['created'] = array(
      '#type' => 'item',
      '#title' => 'Дата создания',
      '#markup' => format_date($node->created, 'small'),
    );

    $form['nodes'][$node->nid]['title'] = array(
      '#type' => 'textfield',
      '#title' => 'Заголовок',
      '#default_value' => $node->title,
      '#required' => TRUE,
    );

    $form['nodes'][$node->nid]['status'] = array(
      '#type' => 'checkbox',
      '#title' => 'Статус',
      '#default_value' => $node->status,
    );
  }

  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => 'Сохранить',
  );

  return $form;
}

/**
 * Implements hook_theme().
 */
function modulename_theme() {
  return array(
    'table_form' => array(
      'render element' => 'form',
    ),
  );
}

/**
 * Format form as table.
 */
function theme_table_form($vars) {
  $form = $vars['form'];
  $header = isset($vars['#header']) ? $vars['#header'] : array();
  $header_created = (bool)$header;
  $rows = array();

  foreach (element_children($form) as $key) {
    foreach (element_children($form[$key]) as $name) {
      // Create header
      if (!$header_created) {
        $header[] = $form[$key][$name]['#title'];
      }

      // Hide title
      $form[$key][$name]['#title_display'] = 'invisible';

      // Cell data
      $cell = array('data' => drupal_render($form[$key][$name]));
      if (isset($form[$key][$name]['#td_attributes'])) {
        $cell += $form[$key][$name]['#td_attributes'];
      }

      $rows[$key]['data'][] = $cell;
    }

    $header_created = TRUE;

    if (isset($form[$key]['#attributes'])) {
      $rows[$key] += $form[$key]['#attributes'];
    }
  }

  return theme('table', array(
    'rows' => $rows,
    'header' => $header,
    'attributes' => isset($form['#attributes']) ? $form['#attributes'] : array(),
    'caption'    => isset($form['#caption'])    ? $form['#caption']   : NULL,
    'colgroups'  => isset($form['#colgroups'])  ? $form['#colgroups'] : NULL,
    'sticky'     => isset($form['#sticky'])     ? $form['#sticky']    : NULL,
    'empty'      => isset($form['#empty'])      ? $form['#empty']     : NULL,
  ));
}

Я уже писал про то, как создавать формы в виде таблицы, на примере формы удаления нод, но этот способ более универсальный — здесь темизируется только часть формы ($form['nodes']) и функция theme_table_form() генерирует колонки автоматически.

Рабочий пример можно посмотреть в демо-модуле.