DrupalのFormAPIでマルチステップフォーム作成の基本

• もちろん、$form_state['ｓｔｏｒａgｅ']の利用も可能です
• 各ステップのフォームで識別文字列を定義します（例：$form_state['pager']='page_1'）

• ステップの判別：　if($form_state['ｐａｇｅr']=='page_1')
• 次のステップのフォーム定義：　$form_state['ｐａｇｅr']=='page_2'
• フォームの再構築：　$form_state['rebuild']==TRUE
  
• マルチステップのサンプルプログラム（送信ボタンを押すとステップ１とステップ２を交替で表示する）

  /**
   *  メニューでURLの定義
   */
  function your_module_menu() {
    $items['form/multiple-step'] = array(
        'title' => t('Multiple Step Form Test'),
        'page callback' => 'drupal_get_form',
        'page arguments' => array('multiple_step_form'),
        'access arguments' => array('access content'),
    );
    return $items;
  }
  
  /**
   *  マルチステップフォームの定義
   */
  function multiple_step_form($form, &$form_state){
  	switch( $form_state['pager'] ) {
          case  'page_1'  :
          return page_one_form();
          break;
  
          case  'page_2'  :
          return page_two_form();
          break;
  	}
  }
  
  /**
   *  ステップ１ フォームの定義
   */
  function page_one_form( $form, &$form_state ){
  　// ステップの定義
    $form_state['pager'] = "page_1";
  　// 任一のメッセージ表示
    $form['message_field'] = array(
        '#type' => 'markup',
        '#markup' => 'Form Step 1',
    );
    // サブミットボタン
    $form['submit'] = array(
        '#type' => 'submit',
        '#value' => '送信',
    );
  　// サブミットボタンのイベントハンドラー
    $form['#submit'][] = 'page_one_form_submit';
  
    return $form;}
  }
  
  /**
   *  ステップ２ フォームの定義
   */
  function page_two_form( $form, &$form_state ){
    // ステップの定義
  　$form_state['pager'] = "page_two";
  　// 任一のメッセージ表示
    $form['test_form']=array(
        '#type' => 'item',
        '#title' => 'Multiple Step Form',
        '#markup' => '<p>Step ２</p>',
    );
  　// サブミットボタン
    $form['submit'] = array(
        '#type' => 'submit',
        '#value' => '送信',
    );
  　// サブミットボタンのイベントハンドラー
    $form['#submit'][] = 'page_two_form_submit';
    return $form;
  }
  
  /**
   *  ステップ１のボタンイベントハンドラー
   */
  function page_one_form_submit($form, &$form_state){
    $form_state['pager']['card_page']= "page_two";
    $form_state['rebuild'] = true;
    return ;
  }
  
  /**
   *  ステップ２のボタンイベントハンドラー
   */
  function page_two_form_submit($form, &$form_state){
    $form_state['pager']['card_page']= "page_one";
    $form_state['rebuild'] = true;
    return ;
  }

  
   

• フォームを作成時にJavascriptを意識しなくてよい
• 事前にフォームの要素を用意して表示/非表示のようなお動作制御
• データ取得するなどの動作制御はできません

• callbak：ajaxのリクエストが来た時に呼び出される関数
• wrapper：ajaxのサーバー処理完了後に結果を画面に表示させる場所の指定

/**
 *  Implementation of hook_menu()
 *  新規フォームを表示するページのメニュー設定
 */
function my_module_name_menu() {
  $items['test/form'] = array(
      'title' => 'Ajaxテスト',
      'page callback' => 'drupal_get_form',
      'page arguments' => array('my_sample_form'),
      'access arguments' => array('access content'),
  );
}

/**
 * フォームの各要素の記述
 */
function my_sample_form($form, &$form_state){
  // メッセージ入力フィールド
  $form['message'] = array(
      '#type' => 'textfield',
      '#title' => t('メッセージを入力'),
  );

  // 入力されたメッセージをajaxで表示する場所
  $form['msg_wrapper'] = array(
      '#type' => 'markup',
      '#markup' => "",
      '#prefix' => '<div id="msg-wrapper">',
      '#suffix' => '</div>',
  );

  // サブミットボタン
  $form['submit'] = array(
      '#type' => 'submit',
      '#value' => '送信',
      '#ajax' => array(
          'callback' => 'test_sample_form_ajax_callback',
          'wrapper' => 'msg-wrapper',
          'effect' => 'fade',
      ),
  );

  return $form;
}

/**
 * ajaxに呼び出される関数
 */
function test_sample_form_ajax_callback($form, $form_state) {
  // 入力されたメッセージを指定した場所にセット
  $form['msg_wrapper']['#markup'] = '入力されたメッセージ：' .
              check_plain($form_state['values']['message']) ;
  // 置換する部品を返す
  return $form['msg_wrapper'] ;
}