最近学习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。
