ng-class指令

概述

ng-class指令实现了把元素的class属性和数据模型绑定的功能。在进行样式动态控制时非常的有用。
ng-class指令实际上有三种。分别为:

指令名称 指令说明
ng-class 在任何元素中都可以使用
ng-class-odd 配合ng-repeat指令使用,$index为偶数时生效
ng-class-even 配合ng-repeat指令使用,$index为奇数时生效

实现细节

三种指令实现上几乎是一模一样的,ng-class-odd和ng-class-even多了一个对$index数据的监控。
核心代码:

响应数据变化

function ngClassWatchAction(newVal) {
  // eslint-disable-next-line no-bitwise
  if (selector === true || (scope.$index & 1) === selector) {
    var newClasses = arrayClasses(newVal || []);
    if (!oldVal) {
      addClasses(newClasses);
    } else if (!equals(newVal,oldVal)) {
      var oldClasses = arrayClasses(oldVal);
      updateClasses(oldClasses, newClasses);
    }
  }
  if (isArray(newVal)) {
    oldVal = newVal.map(function(v) { return shallowCopy(v); });
  } else {
    oldVal = shallowCopy(newVal);
  }
}

这个函数是在监控到ng-class(ng-class-odd或ng-class-even)的值发生变化时调用的。在这个函数中主要进行了三个事情:
1、根据新值获取到需要添加的class名称列表。
2、添加或者更新class列表。
3、保存当前的ng-class的值备用。
其中第一步和第二步是核心。

获取需要添加的class列表

function arrayClasses(classVal) {
    var classes = [];
    if (isArray(classVal)) {
        forEach(classVal, function(v) {
          classes = classes.concat(arrayClasses(v));
        });
        return classes;
    } else if (isString(classVal)) {
        return classVal.split(' ');
    } else if (isObject(classVal)) {
        forEach(classVal, function(v, k) {
          if (v) {
            classes = classes.concat(k.split(' '));
          }
        });
        return classes;
    }
    return classVal;
}

从代码可以看出,ng-class的值支持三种形式:

类型 说明
Array 每一个元素可以为string,Array,Object
string 多个class以空格分隔,每一个class会被直接加入class列表
Object 会遍历Object的属性,只有属性为true的才会被添加到class列表

添加class

当绑定的数据从无变化为有数据的时候会直接调用添加class的方法,代码为:

function removeClasses(classes) {
  var newClasses = digestClassCounts(classes, -1);
  attr.$removeClass(newClasses);
}

这个方法比较简单,只有一个digestClassCounts方法需要注意,在后面会详细说明。

更新class

当绑定的数据从一个值变化到令一个值的时候,就会调用更新class的方法,这个过程只会修改变动的class,其它class不会修改。

function updateClasses(oldClasses, newClasses) {
  var toAdd = arrayDifference(newClasses, oldClasses);
  var toRemove = arrayDifference(oldClasses, newClasses);
  toAdd = digestClassCounts(toAdd, 1);
  toRemove = digestClassCounts(toRemove, -1);
  if (toAdd && toAdd.length) {
    $animate.addClass(element, toAdd);
  }
  if (toRemove && toRemove.length) {
    $animate.removeClass(element, toRemove);
  }
}

这个方法主要干的事情有:
1、获取需要添加和需要删除的class。
2、去除重复的class。
3、添加需要添加的class,删除需要删除的class。
arrayDifference方法主要是计算出第一个参数相对与第二个参数多出来的Array元素,内部为循环遍历,比较简单。

class去除重复

在实际使用的过程中,很有可能会出现多个绑定的数据的值是一样的,导致得到的class列表里面会有重复的值,这个时候为了提高效率,就需要提前去除重复的数据。digestClassCounts方法就是起到了这个作用。

function digestClassCounts(classes, count) {
  // Use createMap() to prevent class assumptions involving property
  // names in Object.prototype
  var classCounts = element.data('$classCounts') || createMap();
  var classesToUpdate = [];
  forEach(classes, function(className) {
    if (count > 0 || classCounts[className]) {
      classCounts[className] = (classCounts[className] || 0) + count;
      if (classCounts[className] === +(count > 0)) {
        classesToUpdate.push(className);
      }
    }
  });
  element.data('$classCounts', classCounts);
  return classesToUpdate.join(' ');
}

添加class时参数count就等于1,删除class时count就等于-1。通过遍历以及之前缓存的每一个class的次数来判断是否需要添加到最终的class列表。

ng-class-odd和ng-class-even特有的处理过程

if (name !== 'ngClass') {
  scope.$watch('$index', function($index, old$index) {
    /* eslint-disable no-bitwise */
    var mod = $index & 1;
    if (mod !== (old$index & 1)) {
      var classes = arrayClasses(scope.$eval(attr[name]));
      if (mod === selector) {
        addClasses(classes);
      } else {
        removeClasses(classes);
      }
    }
    /* eslint-enable */
  });
}

从代码可以看出,对于ng-class-odd和ng-class-even会去监测$index数据,$index数据是ng-repeat的一个默认数据,所以这两个指令更多是配合ng-repeat使用,当然理论是自己控制$index的值来使用这个两个指令也是可以的。

样例代码

ng-class的样例代码

<!DOCTYPE html>
<html lang="en" ng-app="app">
<!--<html>-->
<head>
    <title>Test</title>
    <style>
        .strike {
            text-decoration: line-through;
        }
        .bold {
            font-weight: bold;
        }
        .red {
            color: red;
        }
        .has-error {
            color: red;
            background-color: yellow;
        }
        .orange {
            color: orange;
        }
    </style>
</head>
<body>
<p ng-class="{strike: deleted, bold: important, 'has-error': error}">Map Syntax Example</p>
<label>
    <input type="checkbox" ng-model="deleted">
    deleted (apply "strike" class)
</label><br>
<label>
    <input type="checkbox" ng-model="important">
    important (apply "bold" class)
</label><br>
<label>
    <input type="checkbox" ng-model="error">
    error (apply "has-error" class)
</label>
<hr>
<p ng-class="style">Using String Syntax</p>
<input type="text" ng-model="style"
       placeholder="Type: bold strike red" aria-label="Type: bold strike red">
<hr>
<p ng-class="[style1, style2, style3]">Using Array Syntax</p>
<input ng-model="style1"
       placeholder="Type: bold, strike or red" aria-label="Type: bold, strike or red"><br>
<input ng-model="style2"
       placeholder="Type: bold, strike or red" aria-label="Type: bold, strike or red 2"><br>
<input ng-model="style3"
       placeholder="Type: bold, strike or red" aria-label="Type: bold, strike or red 3"><br>
<hr>
<p ng-class="[style4, {orange: warning}]">Using Array and Map Syntax</p>
<input ng-model="style4" placeholder="Type: bold, strike" aria-label="Type: bold, strike"><br>
<label><input type="checkbox" ng-model="warning"> warning (apply "orange" class)</label>
</body>
<script src="./node_modules/angular/angular.js" type="text/javascript"></script>
<script src="./node_modules/angular-sanitize/angular-sanitize.js" type="text/javascript"></script>
<script>
    angular.module('app', [])
            .controller('ExampleController', ['$scope', function ($scope) {
            }]);
</script>
</html>

在这段代码中实现了使用ng-class来控制元素样式的工程,ng-class多种绑定方式都有。

ng-class-odd和ng-class-even样例代码

<!DOCTYPE html>
<html lang="en" ng-app="app">
<!--<html>-->
<head>
    <title>Test</title>
    <style>
        .odd {
            color: red;
        }
        .even {
            color: blue;
        }
    </style>
</head>
<body>
<ol ng-init="names=['John', 'Mary', 'Cate', 'Suz']">
    <li ng-repeat="name in names">
           <span ng-class-odd="'odd'" ng-class-even="'even'">
             {{name}}
           </span>
    </li>
</ol>
</body>
<script src="./node_modules/angular/angular.js" type="text/javascript"></script>
<script src="./node_modules/angular-sanitize/angular-sanitize.js" type="text/javascript"></script>
<script>
    angular.module('app', [])
            .controller('ExampleController', ['$scope', function ($scope) {
            }]);
</script>
</html>

这段代码实现了ng-class-odd和ng-class-even与ng-repeat配合使用,控制奇偶行显示不同样式的功能。

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

推荐阅读更多精彩内容

  • 1.背景介绍 指令是一个Dom元素上的标签(和元素上的属性, CSS类样式一样,属于这个Dom元素)它告诉Angu...
    cczhuc阅读 1,150评论 0 1
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,633评论 18 139
  • ng-class用于动态绑定标签class 用例: <input type=“number” name...
    报告老师阅读 207评论 0 0
  • AngularJS是什么?AngularJs(后面就简称ng了)是一个用于设计动态web应用的结构框架。首先,它是...
    200813阅读 1,592评论 0 3
  • 第一天 是粉色的傍晚 新的生活 粉粉嫩嫩开场啦
    哈希算法阅读 215评论 0 0