ng-model指令

概述

ng-model指令的作用是把输入型的元素(input,select,textarea等)和scope中的数据进行绑定的作用,也可以用在自定义的form元素上。ng-model指令需要和input、select等指令进行配合使用。
同时ng-model实现了一些默认的数据校验的功能,比如:url、email等格式校验。ng-model还实现了数据状态的控制,比如:数据是否有效,是否是新数据等。如果ng-model在一个form指令中,ng-model指令会把自己的controller添加到form中去,和form建立关联,具体可以看form指令的说明。

详细说明

ng-model指令的restrict属性为'A',所以只支持属性的方式。会依赖form指令(可选),ng-model-option(可选)。

指令的compile

ng-model的compile实现了pre和post两个函数,在pre函数中主要进行的是把ng-model的controller添加到父form中去。核心代码为:

formCtrl.$addControl(modelCtrl);

attr.$observe('name', function(newValue) {
  if (modelCtrl.$name !== newValue) {
    modelCtrl.$$parentForm.$$renameControl(modelCtrl, newValue);
  }
});

scope.$on('$destroy', function() {
  modelCtrl.$$parentForm.$removeControl(modelCtrl);
});

这段代码主要实现的功能:
1、把model的controller添加的form的controller中去,具体实现过程在form指令中。
2、监测属性name,如果属性值发生了变化,就修改form指令中的信息。
3、在ng-model指令销毁的时候删除form指令中的信息。

在post部分实现了对多个消息的监听,代码为:

if (modelCtrl.$options.getOption('updateOn')) {
  element.on(modelCtrl.$options.getOption('updateOn'), function(ev) {
     modelCtrl.$$debounceViewValueCommit(ev && ev.type);
  });
}

element.on('blur', function() {
  if (modelCtrl.$touched) return;

  if ($rootScope.$$phase) {
    scope.$evalAsync(modelCtrl.$setTouched);
  } else {
    scope.$apply(modelCtrl.$setTouched);
  }
});

在这里主要进行了两个过程:
1、监听ng-model-option中updateOn指定的消息,调用model controller的方法,进行数据更新。
2、监听blur消息,会调用$apply或者$evalAsync方法进行页面更新。

指令的controller

在controller中定义了很多个方法:

方法 说明
$$initGetterSetters 初始化get和set方法,需要和option配合使用
$render 默认是空函数
$isEmpty 判断一个值是不是空的
$$updateEmptyClasses 更新是否为empty的css类,设置ng-empty和ng-not-empty类
$setPristine 标记数据是新的,删除ng-dirty类,添加ng-pristine类
$setDirty 标记数据被修改过,和$setPristine刚好相反,会调用父form的$setDirty
$setUntouched 标记为未触摸状态,会设置ng-untouched类
$setTouched 和$setUntouched刚好相反
$rollbackViewValue 数据回滚
$validate 重新计算数据的有效性,受option的allowInvalid属性影响
$$runValidators 直接运行有效性判断
$commitViewValue 提交数据到scope
$$parseAndValidate 解析数据,然后判断有效性,如果有效就会添加到scope中去
$$writeModelToScope 把model中的数据写入scope中去
$setViewValue 设置view里的值
$$debounceViewValueCommit 默认数据提交函数

最后controller中还添加了数据监控:

$scope.$watch(function ngModelWatch() {
   var modelValue = ngModelGet($scope);

   // if scope model value and ngModel value are out of sync
   // TODO(perf): why not move this to the action fn?
   if (modelValue !== ctrl.$modelValue &&
      // checks for NaN is needed to allow setting the model to NaN when there's an asyncValidator
       // eslint-disable-next-line no-self-compare
      (ctrl.$modelValue === ctrl.$modelValue || modelValue === modelValue)
   ) {
     ctrl.$modelValue = ctrl.$$rawModelValue = modelValue;
     parserValid = undefined;

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

     var viewValue = modelValue;
     while (idx--) {
       viewValue = formatters[idx](viewValue);
     }
     if (ctrl.$viewValue !== viewValue) {
       ctrl.$$updateEmptyClasses(viewValue);
       ctrl.$viewValue = ctrl.$$lastCommittedViewValue = viewValue;
       ctrl.$render();

       // It is possible that model and view value have been updated during render
       ctrl.$$runValidators(ctrl.$modelValue, ctrl.$viewValue, noop);
     }
   }

   return modelValue;
 });

在这段代码中主要干的事情:
1、获取ng-model绑定的值
2、根据$formatters属性指定的内容进行数据格式化,所有的格式化函数都会被迭代执行。
3、更新数据,包括更新class,运行有效性校验等。

样例代码

<!DOCTYPE html>
<html lang="en" ng-app="app">
<!--<html>-->
<head>
    <title>Test</title>
</head>
<body>
<style>
    .my-input {
        transition:all linear 0.5s;
        background: transparent;
    }
    .my-input.ng-invalid {
        color:white;
        background: red;
    }
</style>
<p id="inputDescription">
    Update input to see transitions when valid/invalid.
    Integer is a valid value.
</p>
<form name="testForm" ng-controller="ExampleController">
    <input ng-model="val" ng-pattern="/^\d+$/" name="anim" class="my-input"
           aria-describedby="inputDescription" />
</form>
<script src="./node_modules/angular/angular.js" type="text/javascript"></script>
<script>
    angular.module('app', [])
            .controller('ExampleController', ['$scope', function ($scope) {
                $scope.val = '1';
            }]);
</script>
</body>
</html>

这段代码实现了对输入数据进行绑定、格式校验的功能。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 220,295评论 6 512
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,928评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 166,682评论 0 357
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,209评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,237评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,965评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,586评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,487评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,016评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,136评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,271评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,948评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,619评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,139评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,252评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,598评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,267评论 2 358

推荐阅读更多精彩内容