NgModelController: $setViewValue,$render,Formatter, Parser

世有因果知因求果發表於2015-09-05
ControllerViewORM

　　NgModelController為ngModel directive提供了API。這個controller包含了關於data-binding,validation,css update, value formatting and parsing的相關service.該controller本意上設計不包含任何處理DOM渲染或者偵聽DOM events的邏輯。這些DOM相關的邏輯應該由其他使用ngModelController做databinding的directive來完成。Angular為幾乎所有的input elements提供這個DOM邏輯。

$render()

該函式在當view需要更新時呼叫，一般預期ng-modle的使用者需要實現這個方法：

$setViewValue(value, trigger)

該函式用於更新view的value,當需要變更view values時，需要呼叫該方法。典型地，這個函式由DOM的事件處理函式來呼叫。比如，一個input directive在當它的input變更時就會呼叫$setViewValue,再比如：select控制元件在當一個option被選擇時也會呼叫這個函式更新view value。

注意，當$setViewValue被呼叫時，新的value將會被staged，通過$parsers,$validators管道檢查後被commit到view中。

$parsers

這是ngModelController提供的一個函式指標陣列，它將作為一個pipeline，當控制元件從DOM讀取value（由$viewVlaue快取）時，這個$parsers陣列中的所有函式將一個一個地執行。當順序執行完畢後返回的value被傳給$validators函式陣列來做vaildation。如果parse發生錯誤，那麼undefined將被返回。

$formatters

$formatters將包含一個作為pipeline的函式陣列，在model value變更時被呼叫。這些函式將被反序呼叫，每個函式將其返回值傳遞給下一個函式。最後一個函式的輸出作為實際的DOM value($viewValue)

該函式用於format/convert values for display in the control

function formatter(value) {
  if (value) {
    return value.toUpperCase();
  }
}
ngModel.$formatters.push(formatter);

$validators

這是一個當model value變更時將會被呼叫的validator集合。

ngModel.$validators.validCharacters = function(modelValue, viewValue) {
  var value = modelValue || viewValue;
  return /[0-9]+/.test(value) &&
         /[a-z]+/.test(value) &&
         /[A-Z]+/.test(value) &&
         /\W+/.test(value);
};

綜合示例：

app.directive('changeCase', function(){
    return{
        restrict: 'A',
        templateUrl: 'scripts/directives/directive_templates/directive.html',
        require: 'ngModel',
        link: function(scope, element, attr, ngModel){

            ngModel.$formatters.push(function(value){
    value.toUpperCase();
    return value;
});

           ngModel.$parsers.push(function(value){
    value.toUpperCase();
    return value;
});
        }
    };
});
<form role="form" name="myform">
    <div class="form-group">
        <label>View Value:</label>
        <input name="someinput" changecase="" ng-model="some_letters.value">
    </div>
</form>

<strong>ModelValue:</strong>   <br>

 

相關文章