angular指令的transclude学习

最近学习angular，今天将指令中的transclude选项和ng-transclude指令总结一下。本文演示用的angular版本为1.5.11。
首先，angualar指令的transclude选项有三种值：false、true、object。transclude字面意思就是嵌入，也就是说你需不需要将你的指令中的内容（注意不是指令的模板）嵌入到你的模板中去，默认是false。如果你需要这种功能的话，那么就需要将transclude设置为true或者{...}。如果将这个值设置为true或者{...}的话，那么就要配合angular的ng-transclude指令来进行使用。下面我们通过代码来学习如何使用。

页面内容

<body ng-app="transcludeApp">

  <div ng-controller="trascludeCtrl">
    <my-dialog>
      my dialog contents, {{ name }}
    </my-dialog>
  </div>

  <script src="angular.js"></script>
  <script src="transclude.js"></script>
</body>

我们在页面中使用了自定义指令my-dialog,并且在该指令中添加了一段文本内容（指令中的内容）。

transclude.js文件内容

angular.module('transcludeApp', [])
  .controller('trascludeCtrl', ['$scope', function($scope) {
    $scope.name = 'Tobias';
  }])
  .directive('myDialog', function() {
    return {
      restrict: 'E',
      transclude: true,
      scope: {},
      templateUrl: 'my-dialog.html',
      link: function(scope) {
        scope.name = 'Jeff';
      }
    };
  });

my-dialog.html模板文件中的内容

<div class="alert">
  directive template, {{ name }}
  <hr>
  <div ng-transclude>ng-transclude,{{ name }}</div>
</div>

我们查看一下运行结果：

可以看到指令中的内容填充到了指令模板中ng-transclude指令所在的元素中，ng-transclude指令所在元素的内容会被指令内容替代，并且此时指令内容受指令外部的作用域控制；但是当指令中没有任何内容时（空格也不允许），ng-trasclude指令所在元素的内容会显示出来，此时ng-trasclude指令所在元素的内容受指令外部的作用域控制。下面看一下改动代码：

页面更改为

<body ng-app="transcludeApp">

  <div ng-controller="trascludeCtrl">
    <my-dialog></my-dialog>
  </div>

  <script src="angular.js"></script>
  <script src="transclude.js"></script>
</body>

结果变为

接下来，我们来看一下有多个嵌入点的情况，这时指令中的transclude选项是一个对象。请看代码：

页面内容

<body ng-app="transcludeApp">

  <div ng-controller="trascludeCtrl">
    <my-dialog>
      my dialog content, {{ name }}
      <transclude-header>transclude header content, {{ name }}</transclude-header>
      <transclude-body>transclude body content, {{ name }}</transclude-body>
      <!-- <transclude-footer>transclude footer content, {{ name }}</transclude-footer> -->
      my dialog content footer, {{ name }}
    </my-dialog>
  </div>

  <script src="angular.js"></script>
  <script src="transclude.js"></script>
</body>

transclude.js文件内容

angular.module('transcludeApp', [])
  .controller('trascludeCtrl', ['$scope', function($scope) {
    $scope.name = 'Tobias';
  }])
  .directive('myDialog', function() {
    return {
      restrict: 'E',
      transclude: {
        'header': 'transcludeHeader',
        'body': 'transcludeBody',
        'footer': '?transcludeFooter',
      },
      scope: {},
      templateUrl: 'my-dialog.html',
      link: function(scope) {
        scope.name = 'Jeff';
      }
    };
  });

my-dialog.html模板文件内容

<div class="alert">
  directive template, {{ name }}
  <hr>
  <div ng-transclude>ng-transclude,{{ name }}</div>
  <hr>
  <div ng-transclude="header">ng-transclude-header,{{ name }}</div>
  <div ng-transclude="body">ng-transclude-body,{{ name }}</div>
  <div ng-transclude="footer">ng-transclude-footer,{{ name }}</div>
</div>

运行结果

我们的transclude对象定义了如何将多个嵌入点与指令内部的指令嵌入点一一对应，拿'footer': '?transcludeFooter'来解释一下，footer对应指令模板中的一个嵌入点，transcludeFooter对应指令元素内部的那个transclude-footer指令，前面的?表示这个嵌入点不一定有对应的指令存在。根据运行结果，我做出以下推论：首先指令模板替换（嵌入？）页面中指令所在的元素；然后如果指令的transclude选项不为false，则从指令内容中选择指定元素嵌入（替换？）到指令模板中的指定位置，而transclude对象就是确定对应关系的桥梁；最后如果指令中没有对应关系的其它内容都会对应到ng-transclude。

参考文章：angular指令的transclude选项以及ng-transclude指令

angular指令的transclude学习

阿斌

引用和评论

ie下带滚动条容器background属性和border属性的bug