YII2框架中使用yii.js实现的post请求

yii2提供了很多帮助类，比如Html、Url、Json等，可以很方便的实现一些功能，下面简单说下这个Html。用yii2写view时时经常会用到它，今天在改写一个页面时又用到了它。它比较好用的地方就在于，它不仅仅是生成一个简单的html标签，结合yii2自己的静态资源文件yii.js可以很方便的实现一个post请求。

yii2将这些功能都做好了封装，只要在合适的地方调用它的方法就可以了，可以说yii2是个可以开箱即用的框架，你可以用它很快的实现一个需要的功能：比如在页面中放置一个删除按钮，点击按钮发送post请求，弹出确认对话框。如果没有yii\helpers\Html类和yii.js，那么你需要写大量的js/jquery来实现这个功能。如果用yii2的话，下面的代码就可以实现：

     // html代码
     <?= Html::a(
       '删除',
       [
         'delete',
         'id' => $id,
       ],
       [
         'data' => [
           'confirm' => '你确定要删除吗？',
           'method' => 'post',
         ],
       ]
     )
     ?>
     // html代码

它会在页面中生成下面一段html代码：

<a href="delete?id=1" rel="external nofollow" data-confirm="你确定要退出吗？" data-method="post">删除</a>

点击这个按钮会弹出对话框，确认删除后会发送post请求。那么这个post请求是如何发送的呢？到现在为止可是一段js代码都没写呢。

yii2框架隐藏了技术实现的细节，post请求的实现在yii.js中。在yii.js中，定义了window.yii对象，并初始化了window.yii对象的initModule方法：

    window.yii = (function ($) {
      var pub = {
        // 定义了处理事件的方法，比如下面这个：
        confirm: function (message, ok, cancel) {
          if (window.confirm(message)) {
            !ok || ok();
          } else {
            !cancel || cancel();
          }
        },


        handleAction: function ($e, event) {
          var $form = $e.attr('data-form') ? $('#' + $e.attr('data-form')) : $e.closest('form'),
          method = !$e.data('method') && $form ? $form.attr('method') : $e.data('method'),

          // 其他省略

        },

        // 其他省略
      };
      // 初始化模块
      initModule: function (module) {
        if (module.isActive !== undefined && !module.isActive) {
          return;
        }
        if ($.isFunction(module.init)) {
          module.init();
        }
        $.each(module, function () {
          if ($.isPlainObject(this)) {
            pub.initModule(this);
          }
        });
      },

      // 初始化方法
      init: function () {
        initCsrfHandler();
        initRedirectHandler();
        initAssetFilters();
        initDataMethods();
      },

      return pub;
    })(window.jQuery);

    window.jQuery(function () {
      window.yii.initModule(window.yii);
    });

其中上面的initDataMethods()会调用pub.handleAction方法：

      function initDataMethods() {
        var handler = function (event) {
          var $this = $(this),
            method = $this.data('method'),
            message = $this.data('confirm'),
            form = $this.data('form');

          if (method === undefined && message === undefined && form === undefined) {
            return true;
          }

          if (message !== undefined) {
            $.proxy(pub.confirm, this)(message, function () {
              pub.handleAction($this, event);
            });
          } else {
            pub.handleAction($this, event);
          }
          event.stopImmediatePropagation();
          return false;
        };

        // handle data-confirm and data-method for clickable and changeable elements
        $(document).on('click.yii', pub.clickableSelector, handler)
          .on('change.yii', pub.changeableSelector, handler);
      }

可以看到这个方法会获取上面生成的a标签的data属性值，然后交给handlerAction来处理。handlerAction通过动态生成一个form来处理各种请求，最后通过触发submit事件来提交。

    // 其他省略

    $form = $('<form/>', {method: method, action: action});
    var target = $e.attr('target');
    if (target) {
      $form.attr('target', target);
    }
    if (!/(get|post)/i.test(method)) {
      $form.append($('<input/>', {name: '_method', value: method, type: 'hidden'}));
      method = 'post';
      $form.attr('method', method);
    }
    if (/post/i.test(method)) {
      var csrfParam = pub.getCsrfParam();
      if (csrfParam) {
        $form.append($('<input/>', {name: csrfParam, value: pub.getCsrfToken(), type: 'hidden'}));
      }
    }
    $form.hide().appendTo('body');

// 其他省略

PS：做项目用框架很方便，但是框架用的久了，就容易把基本的技术给忘掉了。还是要打好基础呀，这样不管用什么框架都不至于用得云里雾里的。