SOURCE CODE: Uize.Widget.FormDialog
VIEW REFERENCE

/*______________
|       ______  |   U I Z E    J A V A S C R I P T    F R A M E W O R K
|     /      /  |   ---------------------------------------------------
|    /    O /   |    MODULE : Uize.Widget.FormDialog Class
|   /    / /    |
|  /    / /  /| |    ONLINE : http://www.uize.com
| /____/ /__/_| | COPYRIGHT : (c)2007-2012 UIZE
|          /___ |   LICENSE : Available under MIT License or GNU General Public License
|_______________|             http://www.uize.com/license.html
*/

/* Module Meta Data
  type: Class
  importance: 5
  codeCompleteness: 100
  testCompleteness: 0
  docCompleteness: 0
*/

/*?
  Introduction
    The =Uize.Widget.FormDialog= class serves as a thin widget to plumb the value of a =Uize.Widget.Form= widget (or subclass) as the dialog submission value.

    *DEVELOPERS:* `Ben Ilegbodu`
*/

Uize.module ({
  name:'Uize.Widget.FormDialog',
  superclass:'Uize.Widget.Dialog',
  required:'Uize.Widget.Form',
  builder:function (_superclass) {
    /*** Variables for Scruncher Optimization ***/

    /*** Class Constructor ***/
      var
        _class = _superclass.subclass (
          null,
          function() {
            var
              _this = this,
              _false = false,
              _form = _this.addChild(
                'form',
                _this._formWidgetClass,
                {useNormalSubmit:_false}
              )
            ;

            _form.wire(
              'Changed.okToSubmit',
              function() {
                _form.get('okToSubmit')
                  && _this.handleFormValue(
                    function() {
                      _this.fire ({
                        name:'Submission Complete',
                        result:_form.get('value')
                      });

                      _this.set({shown:_false});
                    }
                  )
                ;
              }
            );

            _this.wire({
              Ok:function(_event) {
                _form.submit();
                _event.abort = true;
              },
              'Before Show':function() {
                if (_this._value)
                  _form.set({value:Uize.clone(_this._value)})
                ;
              },
              'After Show':function() { _form.updateUi() },
              'After Hide':function() { _form.reset() }
            });
          }
        )
      ;

    /*** Public Methods ***/
      _class.prototype.handleFormValue = function(_callback) { _callback() };

    /*** Register Properties ***/
      _class.registerProperties ({
        _formWidgetClass:{
          name:'formWidgetClass',
          value:Uize.Widget.Form
        },
        _value:'value'
      });

    return _class;
  }
});