path: root/src/directive/input.js

'use strict';

var URL_REGEXP = /^(ftp|http|https):\/\/(\w+:{0,1}\w*@)?(\S+)(:[0-9]+)?(\/|\/([\w#!:.?+=&%@!\-\/]))?$/;
var EMAIL_REGEXP = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4}$/;
var NUMBER_REGEXP = /^\s*(\-|\+)?(\d+|(\d*(\.\d*)))\s*$/;

var inputType = {

  /**
   * @ngdoc directive
   * @name angular.module.ng.$compileProvider.directive.input.text
   *
   * @description
   * Standard HTML text input with angular data binding.
   *
   * @param {string} ng-model Assignable angular expression to data-bind to.
   * @param {string=} name Property name of the form under which the widgets is published.
   * @param {string=} required Sets `REQUIRED` validation error key if the value is not entered.
   * @param {number=} ng-minlength Sets `MINLENGTH` validation error key if the value is shorter than
   *    minlength.
   * @param {number=} ng-maxlength Sets `MAXLENGTH` validation error key if the value is longer than
   *    maxlength.
   * @param {string=} ng-pattern Sets `PATTERN` validation error key if the value does not match the
   *    RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for
   *    patterns defined as scope expressions.
   * @param {string=} ng-change Angular expression to be executed when input changes due to user
   *    interaction with the input element.
   *
   * @example
      <doc:example>
        <doc:source>
         <script>
           function Ctrl($scope) {
             $scope.text = 'guest';
             $scope.word = /^\w*$/;
           }
         </script>
         <form name="myForm" ng-controller="Ctrl">
           Single word: <input type="text" name="input" ng-model="text"
                               ng-pattern="word" required>
           <span class="error" ng-show="myForm.input.error.REQUIRED">
             Required!</span>
           <span class="error" ng-show="myForm.input.error.PATTERN">
             Single word only!</span>

           <tt>text = {{text}}</tt><br/>
           <tt>myForm.input.valid = {{myForm.input.valid}}</tt><br/>
           <tt>myForm.input.error = {{myForm.input.error}}</tt><br/>
           <tt>myForm.valid = {{myForm.valid}}</tt><br/>
           <tt>myForm.error.REQUIRED = {{!!myForm.error.REQUIRED}}</tt><br/>
          </form>
        </doc:source>
        <doc:scenario>
          it('should initialize to model', function() {
            expect(binding('text')).toEqual('guest');
            expect(binding('myForm.input.valid')).toEqual('true');
          });

          it('should be invalid if empty', function() {
            input('text').enter('');
            expect(binding('text')).toEqual('');
            expect(binding('myForm.input.valid')).toEqual('false');
          });

          it('should be invalid if multi word', function() {
            input('text').enter('hello world');
            expect(binding('myForm.input.valid')).toEqual('false');
          });
        </doc:scenario>
      </doc:example>
   */
  'text': textInputType,


  /**
   * @ngdoc directive
   * @name angular.module.ng.$compileProvider.directive.input.number
   *
   * @description
   * Text input with number validation and transformation. Sets the `NUMBER` validation
   * error if not a valid number.
   *
   * @param {string} ng-model Assignable angular expression to data-bind to.
   * @param {string=} name Property name of the form under which the widgets is published.
   * @param {string=} min Sets the `MIN` validation error key if the value entered is less then `min`.
   * @param {string=} max Sets the `MAX` validation error key if the value entered is greater then `min`.
   * @param {string=} required Sets `REQUIRED` validation error key if the value is not entered.
   * @param {number=} ng-minlength Sets `MINLENGTH` validation error key if the value is shorter than
   *    minlength.
   * @param {number=} ng-maxlength Sets `MAXLENGTH` validation error key if the value is longer than
   *    maxlength.
   * @param {string=} ng-pattern Sets `PATTERN` validation error key if the value does not match the
   *    RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for
   *    patterns defined as scope expressions.
   * @param {string=} ng-change Angular expression to be executed when input changes due to user
   *    interaction with the input element.
   *
   * @example
      <doc:example>
        <doc:source>
         <script>
           function Ctrl($scope) {
             $scope.value = 12;
           }
         </script>
         <form name="myForm" ng-controller="Ctrl">
           Number: <input type="number" name="input" ng-model="value"
                          min="0" max="99" required>
           <span class="error" ng-show="myForm.list.error.REQUIRED">
             Required!</span>
           <span class="error" ng-show="myForm.list.error.NUMBER">
             Not valid number!</span>
           <tt>value = {{value}}</tt><br/>
           <tt>myForm.input.valid = {{myForm.input.valid}}</tt><br/>
           <tt>myForm.input.error = {{myForm.input.error}}</tt><br/>
           <tt>myForm.valid = {{myForm.valid}}</tt><br/>
           <tt>myForm.error.REQUIRED = {{!!myForm.error.REQUIRED}}</tt><br/>
          </form>
        </doc:source>
        <doc:scenario>
          it('should initialize to model', function() {
           expect(binding('value')).toEqual('12');
           expect(binding('myForm.input.valid')).toEqual('true');
          });

          it('should be invalid if empty', function() {
           input('value').enter('');
           expect(binding('value')).toEqual('');
           expect(binding('myForm.input.valid')).toEqual('false');
          });

          it('should be invalid if over max', function() {
           input('value').enter('123');
           expect(binding('value')).toEqual('12');
           expect(binding('myForm.input.valid')).toEqual('false');
          });
        </doc:scenario>
      </doc:example>
   */
  'number': numberInputType,


  /**
   * @ngdoc directive
   * @name angular.module.ng.$compileProvider.directive.input.url
   *
   * @description
   * Text input with URL validation. Sets the `URL` validation error key if the content is not a
   * valid URL.
   *
   * @param {string} ng-model Assignable angular expression to data-bind to.
   * @param {string=} name Property name of the form under which the widgets is published.
   * @param {string=} required Sets `REQUIRED` validation error key if the value is not entered.
   * @param {number=} ng-minlength Sets `MINLENGTH` validation error key if the value is shorter than
   *    minlength.
   * @param {number=} ng-maxlength Sets `MAXLENGTH` validation error key if the value is longer than
   *    maxlength.
   * @param {string=} ng-pattern Sets `PATTERN` validation error key if the value does not match the
   *    RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for
   *    patterns defined as scope expressions.
   * @param {string=} ng-change Angular expression to be executed when input changes due to user
   *    interaction with the input element.
   *
   * @example
      <doc:example>
        <doc:source>
         <script>
           function Ctrl($scope) {
             $scope.text = 'http://google.com';
           }
         </script>
         <form name="myForm" ng-controller="Ctrl">
           URL: <input type="url" name="input" ng-model="text" required>
           <span class="error" ng-show="myForm.input.error.REQUIRED">
             Required!</span>
           <span class="error" ng-show="myForm.input.error.url">
             Not valid url!</span>
           <tt>text = {{text}}</tt><br/>
           <tt>myForm.input.valid = {{myForm.input.valid}}</tt><br/>
           <tt>myForm.input.error = {{myForm.input.error}}</tt><br/>
           <tt>myForm.valid = {{myForm.valid}}</tt><br/>
           <tt>myForm.error.REQUIRED = {{!!myForm.error.REQUIRED}}</tt><br/>
           <tt>myForm.error.url = {{!!myForm.error.url}}</tt><br/>
          </form>
        </doc:source>
        <doc:scenario>
          it('should initialize to model', function() {
            expect(binding('text')).toEqual('http://google.com');
            expect(binding('myForm.input.valid')).toEqual('true');
          });

          it('should be invalid if empty', function() {
            input('text').enter('');
            expect(binding('text')).toEqual('');
            expect(binding('myForm.input.valid')).toEqual('false');
          });

          it('should be invalid if not url', function() {
            input('text').enter('xxx');
            expect(binding('myForm.input.valid')).toEqual('false');
          });
        </doc:scenario>
      </doc:example>
   */
  'url': urlInputType,


  /**
   * @ngdoc directive
   * @name angular.module.ng.$compileProvider.directive.input.email
   *
   * @description
   * Text input with email validation. Sets the `EMAIL` validation error key if not a valid email
   * address.
   *
   * @param {string} ng-model Assignable angular expression to data-bind to.
   * @param {string=} name Property name of the form under which the widgets is published.
   * @param {string=} required Sets `REQUIRED` validation error key if the value is not entered.
   * @param {number=} ng-minlength Sets `MINLENGTH` validation error key if the value is shorter than
   *    minlength.
   * @param {number=} ng-maxlength Sets `MAXLENGTH` validation error key if the value is longer than
   *    maxlength.
   * @param {string=} ng-pattern Sets `PATTERN` validation error key if the value does not match the
   *    RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for
   *    patterns defined as scope expressions.
   *
   * @example
      <doc:example>
        <doc:source>
         <script>
           function Ctrl($scope) {
             $scope.text = 'me@example.com';
           }
         </script>
           <form name="myForm" ng-controller="Ctrl">
             Email: <input type="email" name="input" ng-model="text" required>
             <span class="error" ng-show="myForm.input.error.REQUIRED">
               Required!</span>
             <span class="error" ng-show="myForm.input.error.EMAIL">
               Not valid email!</span>
             <tt>text = {{text}}</tt><br/>
             <tt>myForm.input.valid = {{myForm.input.valid}}</tt><br/>
             <tt>myForm.input.error = {{myForm.input.error}}</tt><br/>
             <tt>myForm.valid = {{myForm.valid}}</tt><br/>
             <tt>myForm.error.REQUIRED = {{!!myForm.error.REQUIRED}}</tt><br/>
             <tt>myForm.error.EMAIL = {{!!myForm.error.EMAIL}}</tt><br/>
           </form>
        </doc:source>
        <doc:scenario>
          it('should initialize to model', function() {
            expect(binding('text')).toEqual('me@example.com');
            expect(binding('myForm.input.valid')).toEqual('true');
          });

          it('should be invalid if empty', function() {
            input('text').enter('');
            expect(binding('text')).toEqual('');
            expect(binding('myForm.input.valid')).toEqual('false');
          });

          it('should be invalid if not email', function() {
            input('text').enter('xxx');
            expect(binding('myForm.input.valid')).toEqual('false');
          });
        </doc:scenario>
      </doc:example>
   */
  'email': emailInputType,


  /**
   * @ngdoc directive
   * @name angular.module.ng.$compileProvider.directive.input.radio
   *
   * @description
   * HTML radio button.
   *
   * @param {string} ng-model Assignable angular expression to data-bind to.
   * @param {string} value The value to which the expression should be set when selected.
   * @param {string=} name Property name of the form under which the widgets is published.
   * @param {string=} ng-change Angular expression to be executed when input changes due to user
   *    interaction with the input element.
   *
   * @example
      <doc:example>
        <doc:source>
         <script>
           function Ctrl($scope) {
             $scope.color = 'blue';
           }
         </script>
         <form name="myForm" ng-controller="Ctrl">
           <input type="radio" ng-model="color" value="red">  Red <br/>
           <input type="radio" ng-model="color" value="green"> Green <br/>
           <input type="radio" ng-model="color" value="blue"> Blue <br/>
           <tt>color = {{color}}</tt><br/>
          </form>
        </doc:source>
        <doc:scenario>
          it('should change state', function() {
            expect(binding('color')).toEqual('blue');

            input('color').select('red');
            expect(binding('color')).toEqual('red');
          });
        </doc:scenario>
      </doc:example>
   */
  'radio': radioInputType,


  /**
   * @ngdoc directive
   * @name angular.module.ng.$compileProvider.directive.input.checkbox
   *
   * @description
   * HTML checkbox.
   *
   * @param {string} ng-model Assignable angular expression to data-bind to.
   * @param {string=} name Property name of the form under which the widgets is published.
   * @param {string=} ng-true-value The value to which the expression should be set when selected.
   * @param {string=} ng-false-value The value to which the expression should be set when not selected.
   * @param {string=} ng-change Angular expression to be executed when input changes due to user
   *    interaction with the input element.
   *
   * @example
      <doc:example>
        <doc:source>
         <script>
           function Ctrl($scope) {
             $scope.value1 = true;
             $scope.value2 = 'YES'
           }
         </script>
         <form name="myForm" ng-controller="Ctrl">
           Value1: <input type="checkbox" ng-model="value1"> <br/>
           Value2: <input type="checkbox" ng-model="value2"
                          ng-true-value="YES" ng-false-value="NO"> <br/>
           <tt>value1 = {{value1}}</tt><br/>
           <tt>value2 = {{value2}}</tt><br/>
          </form>
        </doc:source>
        <doc:scenario>
          it('should change state', function() {
            expect(binding('value1')).toEqual('true');
            expect(binding('value2')).toEqual('YES');

            input('value1').check();
            input('value2').check();
            expect(binding('value1')).toEqual('false');
            expect(binding('value2')).toEqual('NO');
          });
        </doc:scenario>
      </doc:example>
   */
  'checkbox': checkboxInputType,

  'hidden': noop,
  'button': noop,
  'submit': noop,
  'reset': noop
};


function isEmpty(value) {
  return isUndefined(value) || value === '' || value === null || value !== value;
}


function textInputType(scope, element, attr, ctrl) {
  element.bind('blur', function() {
    var touched = ctrl.touch(),
        value = trim(element.val());

    if (ctrl.viewValue !== value) {
      scope.$apply(function() {
        ctrl.read(value);
      });
    } else if (touched) {
      scope.$apply();
    }
  });

  ctrl.render = function() {
    element.val(isEmpty(ctrl.viewValue) ? '' : ctrl.viewValue);
  };

  // pattern validator
  var pattern = attr.ngPattern,
      patternValidator;

  var emit = function(regexp, value) {
    if (isEmpty(value) || regexp.test(value)) {
      ctrl.setValidity('PATTERN', true);
      return value;
    } else {
      ctrl.setValidity('PATTERN', false);
      return undefined;
    }
  };

  if (pattern) {
    if (pattern.match(/^\/(.*)\/$/)) {
      pattern = new RegExp(pattern.substr(1, pattern.length - 2));
      patternValidator = function(value) {
        return emit(pattern, value)
      };
    } else {
      patternValidator = function(value) {
        var patternObj = scope.$eval(pattern);

        if (!patternObj || !patternObj.test) {
          throw new Error('Expected ' + pattern + ' to be a RegExp but was ' + patternObj);
        }
        return emit(patternObj, value);
      };
    }

    ctrl.formatters.push(patternValidator);
    ctrl.parsers.push(patternValidator);
  }

  // min length validator
  if (attr.ngMinlength) {
    var minlength = parseInt(attr.ngMinlength, 10);
    var minLengthValidator = function(value) {
      if (!isEmpty(value) && value.length < minlength) {
        ctrl.setValidity('MINLENGTH', false);
        return undefined;
      } else {
        ctrl.setValidity('MINLENGTH', true);
        return value;
      }
    };

    ctrl.parsers.push(minLengthValidator);
    ctrl.formatters.push(minLengthValidator);
  }

  // max length validator
  if (attr.ngMaxlength) {
    var maxlength = parseInt(attr.ngMaxlength, 10);
    var maxLengthValidator = function(value) {
      if (!isEmpty(value) && value.length > maxlength) {
        ctrl.setValidity('MAXLENGTH', false);
        return undefined;
      } else {
        ctrl.setValidity('MAXLENGTH', true);
        return value;
      }
    };

    ctrl.parsers.push(maxLengthValidator);
    ctrl.formatters.push(maxLengthValidator);
  }
};

function numberInputType(scope, element, attr, ctrl) {
  textInputType(scope, element, attr, ctrl);

  ctrl.parsers.push(function(value) {
    var empty = isEmpty(value);
    if (empty || NUMBER_REGEXP.test(value)) {
      ctrl.setValidity('NUMBER', true);
      return value === '' ? null : (empty ? value : parseFloat(value));
    } else {
      ctrl.setValidity('NUMBER', false);
      return undefined;
    }
  });

  ctrl.formatters.push(function(value) {
    return isEmpty(value) ? '' : '' + value;
  });

  if (attr.min) {
    var min = parseFloat(attr.min);
    var minValidator = function(value) {
      if (!isEmpty(value) && value < min) {
        ctrl.setValidity('MIN', false);
        return undefined;
      } else {
        ctrl.setValidity('MIN', true);
        return value;
      }
    };

    ctrl.parsers.push(minValidator);
    ctrl.formatters.push(minValidator);
  }

  if (attr.max) {
    var max = parseFloat(attr.max);
    var maxValidator = function(value) {
      if (!isEmpty(value) && value > max) {
        ctrl.setValidity('MAX', false);
        return undefined;
      } else {
        ctrl.setValidity('MAX', true);
        return value;
      }
    };

    ctrl.parsers.push(maxValidator);
    ctrl.formatters.push(maxValidator);
  }

  ctrl.formatters.push(function(value) {

    if (isEmpty(value) || isNumber(value)) {
      ctrl.setValidity('NUMBER', true);
      return value;
    } else {
      ctrl.setValidity('NUMBER', false);
      return undefined;
    }
  });
}

function urlInputType(scope, element, attr, ctrl) {
  textInputType(scope, element, attr, ctrl);

  var urlValidator = function(value) {
    if (isEmpty(value) || URL_REGEXP.test(value)) {
      ctrl.setValidity('URL', true);
      return value;
    } else {
      ctrl.setValidity('URL', false);
      return undefined;
    }
  };

  ctrl.formatters.push(urlValidator);
  ctrl.parsers.push(urlValidator);
}

function emailInputType(scope, element, attr, ctrl) {
  textInputType(scope, element, attr, ctrl);

  var emailValidator = function(value) {
    if (isEmpty(value) || EMAIL_REGEXP.test(value)) {
      ctrl.setValidity('EMAIL', true);
      return value;
    } else {
      ctrl.setValidity('EMAIL', false);
      return undefined;
    }
  };

  ctrl.formatters.push(emailValidator);
  ctrl.parsers.push(emailValidator);
}

function radioInputType(scope, element, attr, ctrl) {
  // correct the name
  element.attr('name', attr.id + '@' + attr.name);

  element.bind('click', function() {
    if (element[0].checked) {
      scope.$apply(function() {
        ctrl.touch();
        ctrl.read(attr.value);
      });
    };
  });

  ctrl.render = function() {
    var value = attr.value;
    element[0].checked = isDefined(value) && (value == ctrl.viewValue);
  };
}

function checkboxInputType(scope, element, attr, ctrl) {
  var trueValue = attr.ngTrueValue,
      falseValue = attr.ngFalseValue;

  if (!isString(trueValue)) trueValue = true;
  if (!isString(falseValue)) falseValue = false;

  element.bind('click', function() {
    scope.$apply(function() {
      ctrl.touch();
      ctrl.read(element[0].checked);
    });
  });

  ctrl.render = function() {
    element[0].checked = ctrl.viewValue;
  };

  ctrl.formatters.push(function(value) {
    return value === trueValue;
  });

  ctrl.parsers.push(function(value) {
    return value ? trueValue : falseValue;
  });
}


/**
 * @ngdoc directive
 * @name angular.module.ng.$compileProvider.directive.textarea
 *
 * @description
 * HTML textarea element widget with angular data-binding. The data-binding and validation
 * properties of this element are exactly the same as those of the
 * {@link angular.module.ng.$compileProvider.directive.input input element}.
 *
 * @param {string} ng-model Assignable angular expression to data-bind to.
 * @param {string=} name Property name of the form under which the widgets is published.
 * @param {string=} required Sets `REQUIRED` validation error key if the value is not entered.
 * @param {number=} ng-minlength Sets `MINLENGTH` validation error key if the value is shorter than
 *    minlength.
 * @param {number=} ng-maxlength Sets `MAXLENGTH` validation error key if the value is longer than
 *    maxlength.
 * @param {string=} ng-pattern Sets `PATTERN` validation error key if the value does not match the
 *    RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for
 *    patterns defined as scope expressions.
 * @param {string=} ng-change Angular expression to be executed when input changes due to user
 *    interaction with the input element.
 */


/**
 * @ngdoc directive
 * @name angular.module.ng.$compileProvider.directive.input
 *
 * @description
 * HTML input element widget with angular data-binding. Input widget follows HTML5 input types
 * and polyfills the HTML5 validation behavior for older browsers.
 *
 * @param {string} ng-model Assignable angular expression to data-bind to.
 * @param {string=} name Property name of the form under which the widgets is published.
 * @param {string=} required Sets `REQUIRED` validation error key if the value is not entered.
 * @param {number=} ng-minlength Sets `MINLENGTH` validation error key if the value is shorter than
 *    minlength.
 * @param {number=} ng-maxlength Sets `MAXLENGTH` validation error key if the value is longer than
 *    maxlength.
 * @param {string=} ng-pattern Sets `PATTERN` validation error key if the value does not match the
 *    RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for
 *    patterns defined as scope expressions.
 * @param {string=} ng-change Angular expression to be executed when input changes due to user
 *    interaction with the input element.
 *
 * @example
    <doc:example>
      <doc:source>
       <script>
         function Ctrl($scope) {
           $scope.user = {name: 'guest', last: 'visitor'};
         }
       </script>
       <div ng-controller="Ctrl">
         <form name="myForm">
           User name: <input type="text" name="userName" ng-model="user.name" required>
           <span class="error" ng-show="myForm.userName.error.REQUIRED">
             Required!</span><br>
           Last name: <input type="text" name="lastName" ng-model="user.last"
             ng-minlength="3" ng-maxlength="10">
           <span class="error" ng-show="myForm.lastName.error.MINLENGTH">
             Too short!</span>
           <span class="error" ng-show="myForm.lastName.error.MAXLENGTH">
             Too long!</span><br>
         </form>
         <hr>
         <tt>user = {{user}}</tt><br/>
         <tt>myForm.userName.valid = {{myForm.userName.valid}}</tt><br>
         <tt>myForm.userName.error = {{myForm.userName.error}}</tt><br>
         <tt>myForm.lastName.valid = {{myForm.lastName.valid}}</tt><br>
         <tt>myForm.userName.error = {{myForm.lastName.error}}</tt><br>
         <tt>myForm.valid = {{myForm.valid}}</tt><br>
         <tt>myForm.error.REQUIRED = {{!!myForm.error.REQUIRED}}</tt><br>
         <tt>myForm.error.MINLENGTH = {{!!myForm.error.MINLENGTH}}</tt><br>
         <tt>myForm.error.MAXLENGTH = {{!!myForm.error.MAXLENGTH}}</tt><br>
       </div>
      </doc:source>
      <doc:scenario>
        it('should initialize to model', function() {
          expect(binding('user')).toEqual('{"last":"visitor","name":"guest"}');
          expect(binding('myForm.userName.valid')).toEqual('true');
          expect(binding('myForm.valid')).toEqual('true');
        });

        it('should be invalid if empty when required', function() {
          input('user.name').enter('');
          expect(binding('user')).toEqual('{"last":"visitor","name":null}');
          expect(binding('myForm.userName.valid')).toEqual('false');
          expect(binding('myForm.valid')).toEqual('false');
        });

        it('should be valid if empty when min length is set', function() {
          input('user.last').enter('');
          expect(binding('user')).toEqual('{"last":"","name":"guest"}');
          expect(binding('myForm.lastName.valid')).toEqual('true');
          expect(binding('myForm.valid')).toEqual('true');
        });

        it('should be invalid if less than required min length', function() {
          input('user.last').enter('xx');
          expect(binding('user')).toEqual('{"last":"visitor","name":"guest"}');
          expect(binding('myForm.lastName.valid')).toEqual('false');
          expect(binding('myForm.lastName.error')).toMatch(/MINLENGTH/);
          expect(binding('myForm.valid')).toEqual('false');
        });

        it('should be valid if longer than max length', function() {
          input('user.last').enter('some ridiculously long name');
          expect(binding('user'))
            .toEqual('{"last":"visitor","name":"guest"}');
          expect(binding('myForm.lastName.valid')).toEqual('false');
          expect(binding('myForm.lastName.error')).toMatch(/MAXLENGTH/);
          expect(binding('myForm.valid')).toEqual('false');
        });
      </doc:scenario>
    </doc:example>
 */
var inputDirective = [function() {
  return {
    restrict: 'E',
    require: '?ngModel',
    link: function(scope, element, attr, ctrl) {
      if (ctrl) {
        (inputType[lowercase(attr.type)] || inputType.text)(scope, element, attr, ctrl);
      }
    }
  };
}];


/**
 * @ngdoc object
 * @name angular.module.ng.$compileProvider.directive.ng-model.NgModelController
 *
 * @property {string} viewValue Actual string value in the view.
 * @property {*} modelValue The value in the model, that the widget is bound to.
 * @property {Array.<Function>} parsers Whenever the widget reads value from the DOM, it executes
 *     all of these functions to sanitize / convert the value as well as validate.
 *
 * @property {Array.<Function>} formatters Wheneveer the model value changes, it executes all of
 *     these functions to convert the value as well as validate.
 *
 * @property {Object} error An bject hash with all errors as keys.
 *
 * @property {boolean} pristine True if user has not interacted with the widget yet.
 * @property {boolean} dirty True if user has already interacted with the widget.
 * @property {boolean} valid True if there is no error.
 * @property {boolean} invalid True if at least one error on the widget.
 *
 * @description
 *
 */
var NgModelController = ['$scope', '$exceptionHandler', '$attrs', 'ngModel',
    function($scope, $exceptionHandler, $attr, ngModel) {
  this.viewValue = Number.NaN;
  this.modelValue = Number.NaN;
  this.parsers = [];
  this.formatters = [];
  this.error = {};
  this.pristine = true;
  this.dirty = false;
  this.valid = true;
  this.invalid = false;
  this.render = noop;
  this.widgetId = $attr.name;


  /**
   * @ngdoc function
   * @name angular.module.ng.$compileProvider.directive.ng-model.NgModelController#touch
   * @methodOf angular.module.ng.$compileProvider.directive.ng-model.NgModelController
   *
   * @return {boolean} Whether it did change state.
   *
   * @description
   * This method should be called from within a DOM event handler.
   * For example {@link angular.module.ng.$compileProvider.directive.input input} or
   * {@link angular.module.ng.$compileProvider.directive.select select} directives call it.
   *
   * It changes state to `dirty` and emits `$viewTouch` event if the state was `pristine` before.
   */
  this.touch = function() {
    if (this.dirty) return false;

    this.dirty = true;
    this.pristine = false;
    try {
      $scope.$emit('$viewTouch');
    } catch (e) {
      $exceptionHandler(e);
    }
    return true;
  };


  /**
   * @ngdoc function
   * @name angular.module.ng.$compileProvider.directive.ng-model.NgModelController#setValidity
   * @methodOf angular.module.ng.$compileProvider.directive.ng-model.NgModelController
   *
   * @description
   * Change the validity state, and notifies the form when the widget changes validity. (i.e. does
   * not emit `$invalid` if given validator is already marked as invalid).
   *
   * This method should be called by validators - ie the parser or formatter method.
   *
   * @param {string} name Name of the validator.
   * @param {boolean} isValid Whether it should $emit `$valid` (true) or `$invalid` (false) event.
   */
  this.setValidity = function(name, isValid) {

    if (!isValid && this.error[name]) return;
    if (isValid && !this.error[name]) return;

    if (isValid) {
      delete this.error[name];
      if (equals(this.error, {})) {
        this.valid = true;
        this.invalid = false;
      }
    } else {
      this.error[name] = true;
      this.invalid = true;
      this.valid = false;
    }

    return $scope.$emit(isValid ? '$valid' : '$invalid', name, this);
  };


  /**
   * @ngdoc function
   * @name angular.module.ng.$compileProvider.directive.ng-model.NgModelController#read
   * @methodOf angular.module.ng.$compileProvider.directive.ng-model.NgModelController
   *
   * @description
   * Read a value from view.
   *
   * This method should be called from within a DOM event handler.
   * For example {@link angular.module.ng.$compileProvider.directive.input input} or
   * {@link angular.module.ng.$compileProvider.directive.select select} directives call it.
   *
   * It internally calls all `formatters` and if resulted value is valid, update the model and emits
   * `$viewChange` event afterwards.
   *
   * @param {string} value Value from the view
   */
  this.read = function(value) {
    this.viewValue = value;

    forEach(this.parsers, function(fn) {
      value = fn(value);
    });

    if (isDefined(value) && this.model !== value) {
      this.modelValue = value;
      ngModel(value);
      $scope.$emit('$viewChange', value, this);
    }
  };

  // model -> value
  var ctrl = this;
  $scope.$watch(function() {
    return ngModel();
  }, function(value) {

    // ignore change from view
    if (ctrl.modelValue === value) return;

    var formatters = ctrl.formatters,
        idx = formatters.length;

    ctrl.modelValue = value;
    while(idx--) {
      value = formatters[idx](value);
    }

    if (isDefined(value) && ctrl.viewValue !== value) {
      ctrl.viewValue = value;
      ctrl.render();
    }
  });
}];


/**
 * @ngdoc directive
 * @name angular.module.ng.$compileProvider.directive.ng-model
 *
 * @element input
 *
 * @description
 * Is directive that tells Angular to do two-way data binding. It works together with `input`,
 * `select`, `textarea`. You can easily write your own directives to use `ng-model` as well.
 *
 * `ng-model` is responsible for:
 *
 * - binding the view into the model, which other directives such as `input`, `textarea` or `select`
 *   require,
 * - providing validation behavior (i.e. required, number, email, url),
 * - keeping state of the widget (valid/invalid, dirty/pristine, validation errors),
 * - setting related css class onto the element (`ng-valid`, `ng-invalid`, `ng-dirty`, `ng-pristine`),
 * - register the widget with parent {@link angular.module.ng.$compileProvider.directive.form form}.
 *
 * For basic examples, how to use `ng-model`, see:
 *
 *  - {@link angular.module.ng.$compileProvider.directive.input input}
 *    - {@link angular.module.ng.$compileProvider.directive.input.text text}
 *    - {@link angular.module.ng.$compileProvider.directive.input.checkbox checkbox}
 *    - {@link angular.module.ng.$compileProvider.directive.input.radio radio}
 *    - {@link angular.module.ng.$compileProvider.directive.input.number number}
 *    - {@link angular.module.ng.$compileProvider.directive.input.email email}
 *    - {@link angular.module.ng.$compileProvider.directive.input.url url}
 *  - {@link angular.module.ng.$compileProvider.directive.select select}
 *  - {@link angular.module.ng.$compileProvider.directive.textarea textarea}
 *
 */
var ngModelDirective = [function() {
  return {
    inject: {
      ngModel: 'accessor'
    },
    require: 'ngModel',
    controller: NgModelController,
    link: function(scope, element, attr, ctrl) {
      // notify others, especially parent forms
      scope.$emit('$newFormControl', ctrl);

      forEach(['valid', 'invalid', 'pristine', 'dirty'], function(name) {
        scope.$watch(function() {
          return ctrl[name];
        }, function(value) {
          element[value ? 'addClass' : 'removeClass']('ng-' + name);
        });
      });

      element.bind('$destroy', function() {
        scope.$emit('$destroy', ctrl);
      });
    }
  };
}];


/**
 * @ngdoc directive
 * @name angular.module.ng.$compileProvider.directive.ng-change
 *
 * @description
 * Evaluate given expression when user changes the input.
 * The expression is not evaluated when the value change is coming from the model.
 *
 * Note, this directive requires `ng-model` to be present.
 *
 * @element input
 *
 * @example
 * <doc:example>
 *   <doc:source>
 *     <script>
 *       function Controller($scope) {
 *         $scope.counter = 0;
 *         $scope.change = function() {
 *           $scope.counter++;
 *         };
 *       }
 *     </script>
 *     <div ng-controller="Controller">
 *       <input type="checkbox" ng-model="confirmed" ng-change="change()" id="ng-change-example1" />
 *       <input type="checkbox" ng-model="confirmed" id="ng-change-example2" />
 *       <label for="ng-change-example2">Confirmed</label><br />
 *       debug = {{confirmed}}<br />
 *       counter = {{counter}}
 *     </div>
 *   </doc:source>
 *   <doc:scenario>
 *     it('should evaluate the expression if changing from view', function() {
 *       expect(binding('counter')).toEqual('0');
 *       element('#ng-change-example1').click();
 *       expect(binding('counter')).toEqual('1');
 *       expect(binding('confirmed')).toEqual('true');
 *     });
 *
 *     it('should not evaluate the expression if changing from model', function() {
 *       element('#ng-change-example2').click();
 *       expect(binding('counter')).toEqual('0');
 *       expect(binding('confirmed')).toEqual('true');
 *     });
 *   </doc:scenario>
 * </doc:example>
 */
var ngChangeDirective = valueFn({
  require: 'ngModel',
  link: function(scope, element, attr, ctrl) {
    scope.$on('$viewChange', function(event, value, widget) {
      if (ctrl === widget) scope.$eval(attr.ngChange);
    });
  }
});


/**
 * @ngdoc directive
 * @name angular.module.ng.$compileProvider.directive.ng-model-instant
 *
 * @element input
 *
 * @description
 * By default, Angular udpates the model only on `blur` event - when the input looses focus.
 * If you want to update after every key stroke, use `ng-model-instant`.
 *
 * @example
 * <doc:example>
 *   <doc:source>
 *     First name: <input type="text" ng-model="firstName" /><br />
 *     Last name: <input type="text" ng-model="lastName" ng-model-instant /><br />
 *
 *     First name ({{firstName}}) is only updated on `blur` event, but the last name ({{lastName}})
 *     is updated immediately, because of using `ng-model-instant`.
 *   </doc:source>
 *   <doc:scenario>
 *     it('should update first name on blur', function() {
 *       input('firstName').enter('santa', 'blur');
 *       expect(binding('firstName')).toEqual('santa');
 *     });
 *
 *     it('should update last name immediately', function() {
 *       input('lastName').enter('santa', 'keydown');
 *       expect(binding('lastName')).toEqual('santa');
 *     });
 *   </doc:scenario>
 * </doc:example>
 */
var ngModelInstantDirective = ['$browser', function($browser) {
  return {
    require: 'ngModel',
    link: function(scope, element, attr, ctrl) {
      var handler = function() {
        var touched = ctrl.touch(),
              value = trim(element.val());

          if (ctrl.viewValue !== value) {
            scope.$apply(function() {
              ctrl.read(value);
            });
          } else if (touched) {
            scope.$apply();
          }
      };

      var timeout;
      element.bind('keydown', function(event) {
        var key = event.keyCode;

        //    command            modifiers                   arrows
        if (key === 91 || (15 < key && key < 19) || (37 <= key && key <= 40)) return;

        if (!timeout) {
          timeout = $browser.defer(function() {
            handler();
            timeout = null;
          });
        }
      });

      element.bind('change input', handler);
    }
  };
}];


var requiredDirective = [function() {
  return {
    require: '?ngModel',
    link: function(scope, elm, attr, ctrl) {
      if (!ctrl) return;

      var validator = function(value) {
        if (attr.required && isEmpty(value)) {
          ctrl.setValidity('REQUIRED', false);
          return null;
        } else {
          ctrl.setValidity('REQUIRED', true);
          return value;
        }
      };

      ctrl.formatters.push(validator);
      ctrl.parsers.unshift(validator);

      attr.$observe('required', function() {
        validator(ctrl.viewValue);
      });
    }
  };
}];


/**
 * @ngdoc directive
 * @name angular.module.ng.$compileProvider.directive.ng-list
 *
 * @description
 * Text input that converts between comma-seperated string into an array of strings.
 *
 * @element input
 *
 * @example
    <doc:example>
      <doc:source>
       <script>
         function Ctrl($scope) {
           $scope.names = ['igor', 'misko', 'vojta'];
         }
       </script>
       <form name="myForm" ng-controller="Ctrl">
         List: <input name="input" ng-model="names" ng-list required>
         <span class="error" ng-show="myForm.list.error.REQUIRED">
           Required!</span>
         <tt>names = {{names}}</tt><br/>
         <tt>myForm.input.valid = {{myForm.input.valid}}</tt><br/>
         <tt>myForm.input.error = {{myForm.input.error}}</tt><br/>
         <tt>myForm.valid = {{myForm.valid}}</tt><br/>
         <tt>myForm.error.REQUIRED = {{!!myForm.error.REQUIRED}}</tt><br/>
        </form>
      </doc:source>
      <doc:scenario>
        it('should initialize to model', function() {
          expect(binding('names')).toEqual('["igor","misko","vojta"]');
          expect(binding('myForm.input.valid')).toEqual('true');
        });

        it('should be invalid if empty', function() {
          input('names').enter('');
          expect(binding('names')).toEqual('[]');
          expect(binding('myForm.input.valid')).toEqual('false');
        });
      </doc:scenario>
    </doc:example>
 */
var ngListDirective = function() {
  return {
    require: 'ngModel',
    link: function(scope, element, attr, ctrl) {
      var parse = function(viewValue) {
        var list = [];

        if (viewValue) {
          forEach(viewValue.split(/\s*,\s*/), function(value) {
            if (value) list.push(value);
          });
        }

        return list;
      };

      ctrl.parsers.push(parse);
      ctrl.formatters.push(function(value) {
        if (isArray(value) && !equals(parse(ctrl.viewValue), value)) {
          return value.join(', ');
        }

        return undefined;
      });
    }
  };
};