Improve this doc View Source

Input with month validation and transformation. In browsers that do not yet support the HTML5 month input, a text element will be used. In that case, the text must be entered in a valid ISO-8601 month format (yyyy-MM), for example: `2009-01`. The model must always be a Date object. In the event the model is not set to the first of the month, the first of that model's month is assumed.

## Directive Info

- This directive executes at priority level 0.

## Usage

    <input type="month"
           ng-model=""
           [name=""]
           [min=""]
           [max=""]
           [required=""]
           [ng-required=""]
           [ng-change=""]>

### Arguments

Param | Type | Details
--- | --- | ---
ngModel | string | Assignable angular expression to data-bind to.
name (optional) | string | Property name of the form under which the control is published.
min (optional) | string | Sets the `min` validation error key if the value entered is less than `min`. This must be a valid ISO month format (yyyy-MM).
max (optional) | string | Sets the `max` validation error key if the value entered is greater than `max`. This must be a valid ISO month format (yyyy-MM).
required (optional) | string | Sets `required` validation error key if the value is not entered.
ngRequired (optional) | string | Adds `required` attribute and `required` validation constraint to the element when the ngRequired expression evaluates to true. Use `ngRequired` instead of `required` when you want to data-bind to the `required` attribute.
ngChange (optional) | string | Angular expression to be executed when input changes due to user interaction with the input element.

## Example

Edit in Plunker

    <script>
     function Ctrl($scope) {
       $scope.value = new Date(2013, 9, 1);
     }
    </script>
    <form name="myForm" ng-controller="Ctrl as dateCtrl">
      Pick a month int 2013:
      <input id="exampleInput" type="month" name="input" ng-model="value"
         placeholder="yyyy-MM" min="2013-01" max="2013-12" required />
      <span class="error" ng-show="myForm.input.$error.required">
         Required!</span>
      <span class="error" ng-show="myForm.input.$error.month">
         Not a valid month!</span>
      <tt>value = {{value | date: "yyyy-MM"}}</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>

    var value = element(by.binding('value | date: "yyyy-MM"'));
    var valid = element(by.binding('myForm.input.$valid'));
    var input = element(by.model('value'));

    // currently protractor/webdriver does not support
    // sending keys to all known HTML5 input controls
    // for various browsers (https://github.com/angular/protractor/issues/562).
    function setInput(val) {
      // set the value of the element and force validation.
      var scr = "var ipt = document.getElementById('exampleInput'); " +
      "ipt.value = '" + val + "';" +
      "angular.element(ipt).scope().$apply(function(s) { s.myForm[ipt.name].$setViewValue('" + val + "'); });";
      browser.executeScript(scr);
    }

    it('should initialize to model', function() {
      expect(value.getText()).toContain('2013-10');
      expect(valid.getText()).toContain('myForm.input.$valid = true');
    });

    it('should be invalid if empty', function() {
      setInput('');
      expect(value.getText()).toEqual('value =');
      expect(valid.getText()).toContain('myForm.input.$valid = false');
    });

    it('should be invalid if over max', function() {
      setInput('2015-01');
      expect(value.getText()).toContain('');
      expect(valid.getText()).toContain('myForm.input.$valid = false');
    });