angular.js指令中transclude选项及ng-transclude指令详解
前言
在开始本文之前，首先要说明我们使用的angular的版本是1.5.0，因为不同版本的表现结果不是那么相同。
首先我们应该了解到，在angular指令的选项中，有一项是transclude，这个选项有三种值：false，true，object；那这三种值分别表示什么，该如何选择？
下面我们来详细的说明一下。
transclude字面意思就是嵌入，也就是说你需不需要将你的指令内部的元素（注意不是指令的模板）嵌入到你的模板中去，默认是false。如果你需要这种功能的话，那么就需要将transclude设置为true或者{...}。如果将这个值设置为true或者{...}的话，那么就要配合angular的ng-transclude指令来进行使用，好，废话不多说了，看代码是最好的学习方法，我们下面就来根据代码来了解掌握这些东西。
代码的结果可以在这里看到，完整的代码会在后面贴出来。
现在我们来看第一个指令部分
1、在页面中使用的形式
<!-- 指令one-transclude 内部含有元素--> <one-transclude class="one-transclude-self"> <div class="one-transclude-self__footer">$AAAAAA $我是指令[one-transclude]元素内部的内容</div> </one-transclude>
我们定义了一个名字叫做one-transclude的指令，也就是说这个指令的模板中只有一个嵌入点的，指令内部是有一些元素的我给内部的元素的内容做了一些标记，方便我们后面观察。
2、JavaScript代码部分
angular.module('app', [])
.directive('oneTransclude', oneTransclude);
function oneTransclude() {
return {
restrict: 'AE',
transclude: true,
templateUrl: 'one-transclude.html'
};
}
我们在JavaScript中定义oneTransclude，注意我们这里transclude=true，表明我们希望在模板中将指令的内部元素嵌入到模板中的某个位置。
3、指令的模板部分
<div class="one-transclude"> <div class="one-transclude__title"> $BBBBBB$ 我是指令[one-transclude]模板的内容 </div> <hr> <ng-transclude> $CCCCCC$ 我是指令[one-transclude]模板中[ng-transclude]中的内容 </ng-transclude> </div>
上面书写了我们的指令模板，可以看到我们的模板由两部分组成，一部分是含有ng-transclude指令的，一部分是不含有这个指令的。当然我也把这些里面的内容作了一些标记，方便后面我们观察。因为这里的ng-transclude后面不带有参数，所以指令里面的元素就是那些以$AAAAAA$开头的整块元素都会嵌入到指令模板中含有ng-transclude指令的内部，还要注意，如果指令模板中含有ng-transclude指令的元素内部也有元素的话，那么这些元素会被替代。还有一种情况，那就是如果指令里面不含有元素，那么指令模板里面的含有ng-transclude指令的元素的内部元素会显示出来
4、我们可以看下图更直观的了解一下。
多个嵌入点的情况，这时候指令内部的ng-transclude的值是一个对象，一种映射关系；具体的可以看下面的代码：
5、指令在页面中使用的代码：
<!-- 指令mutil-transclude --> <multi-transclude> <multi-transclude-title>我是指令元素内部的title</multi-transclude-title> <multi-transclude-body>我是指令元素内部的body</multi-transclude-body> <multi-transclude-footer>我是指令元素内部的footer</multi-transclude-footer> </multi-transclude>
我们在页面中使用了multi-transclude这个指令，在指令的内部还有三个指令，这内部的三个指令要以E的形式应用，不然会出现问题，看到这里不明白的没关系，继续往下看。
6、JavaScript代码中的指令：
angular.module('app', [])
.directive('multiTransclude', multiTransclude);
function multiTransclude() {
return {
restrict: 'AE',
transclude: {
'title': 'multiTranscludeTitle',
'body': 'multiTranscludeBody',
'footer': '?multiTranscludeFooter'
},
templateUrl: 'multi-transclude.html'
};
}
我们的transclude对象定义了如何将多个嵌入点与指令内部的指令嵌入点一一对应，拿'footer': '?multiTranscludeFooter'来解释一下，footer对应指令模板中的一个嵌入点，multiTranscludeFooter对应指令元素内部的哪个multi-transclude-footer指令，前面的?表示这个嵌入点不一定有对应的指令存在。当然multiTranscludeFooter是我们自己定义的，可以随意定义，但是尽量做到让大家一看就知道是对应哪个嵌入点就行。
7、指令对应的模板
<div class="multi-transclude"> <div class="multi-transclude__title" ng-transclude="title"></div> <div>忽略我,我就是证明我是在模板中的1</div> <div class="multi-transclude__body" ng-transclude="body"></div> <div>忽略我,我就是证明我是在模板中的2</div> <div class="multi-transclude__footer" ng-transclude="footer"></div> </div>
从上面的模板中我们可以看到，指令ng-transclude后面的字符串就是我们定义的嵌入点，也就是上面指令定义时候用到的那些字符串。
到这里关于ng-transclude以及angular指令的transclude选项我想大家应该都明白了。
完整的代码部分
1、index.html
<body ng-controller="MyController as vm"> <h1 ng-bind="vm.title"></h1> <h2>指令one-transclude 内部含有元素</h2> <!-- 指令one-transclude 内部含有元素--> <one-transclude class="one-transclude-self"> <div class="one-transclude-self__footer">$AAAAAA $我是指令[one-transclude]元素内部的内容</div> </one-transclude> <h2>指令one-transclude 内部不含有元素</h2> <!-- 指令one-transclude 内部不含有元素 --> <one-transclude class="one-transclude-self"></one-transclude> <h2>指令mutil-transclude</h2> <!-- 指令mutil-transclude --> <multi-transclude> <multi-transclude-title>我是指令元素内部的title</multi-transclude-title> <multi-transclude-body>我是指令元素内部的body</multi-transclude-body> <multi-transclude-footer>我是指令元素内部的footer</multi-transclude-footer> </multi-transclude> </body>
2、app.js
(function() {
angular.module('app', [])
.controller('MyController', myController)
.directive('oneTransclude', oneTransclude)
.directive('multiTransclude', multiTransclude);
myController.$inject = [];
function myController() {
var vm = this;
vm.title = 'ng-transclude';
}
function oneTransclude() {
return {
restrict: 'AE',
transclude: true,
templateUrl: 'one-transclude.html'
};
}
function multiTransclude() {
return {
restrict: 'AE',
transclude: {
'title': 'multiTranscludeTitle',
'body': 'multiTranscludeBody',
'footer': '?multiTranscludeFooter'
},
templateUrl: 'multi-transclude.html'
};
}
})();
3、one-transclude.html
<div class="one-transclude"> <div class="one-transclude__title"> $BBBBBB$ 我是指令[one-transclude]模板的内容 </div> <hr> <ng-transclude> $CCCCCC$ 我是指令[one-transclude]模板中[ng-transclude]中的内容 </ng-transclude> </div>
4、multi-transclude.html
<div class="multi-transclude"> <div class="multi-transclude__title" ng-transclude="title"></div> <div>忽略我,我就是证明我是在模板中的1</div> <div class="multi-transclude__body" ng-transclude="body"></div> <div>忽略我,我就是证明我是在模板中的2</div> <div class="multi-transclude__footer" ng-transclude="footer"></div> </div>
总结
以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流，谢谢大家对脚本之家的支持。
相关文章
- 这篇文章主要给大家介绍了关于在Angular.js中下拉框实现渲染html的方法，文中通过示例代码介绍的非常详细，对大家具有一定的参考学习价值，需要的朋友们下面来跟着小编一起来学习学习吧。...2017-06-24
angular.js指令中transclude选项及ng-transclude指令详解
这篇文章主要研究一下如何使用ng-transclude指令,以及指令的transclude选项的相关资料，文中介绍的非常详细，并给出了完整的示例代码大家参考学习，需要的朋友们下面来一起看看吧。...2017-05-27Angular2中Bootstrap界面库ng-bootstrap详解
不知道大家有没有留意，最近angular-ui团队终于正式发布了基于 Angular2的Bootstrap界面库ng-bootstrap ，之前工作中一直在用 AngularJS 1.x 的UI Bootstrap ， 因此对这个ng-bootstrap 也是很感兴趣，所以第一时间进行试用。这篇文章就给大家详细介绍下ng-bootstrap。...2016-10-20- 这篇文章主要介绍了Angular.js基础学习之初始化的相关资料，AngularJS 启动有两种方式，一种是绑定初始化，自动加载，另外一种是手动初始化，文中介绍的很详细，需要的朋友可以参考下。...2017-03-13
- 这篇文章主要给大家介绍了关于Angular.js指令学习中一些重要属性的用法教程，文中介绍的非常详细，对大家具有一定的参考学习价值，需要的朋友们下面来一起看看吧。...2017-05-27
Angular.js中ng-if、ng-show和ng-hide的区别介绍
angularJS中的ng-show、ng-hide、ng-if指令都可以用来控制dom元素的显示或隐藏。那么这篇文章就给大家主要介绍了Angular.js中ng-if、ng-show和ng-hide的区别，需要的朋友可以参考借鉴，下面来一起看看吧。...2017-01-23AngularJS ng-repeat数组有重复值的解决方法
不知道大家是否遇到过这个问题，在当Angular.JS ng-repeat数组中有重复项时，系统就会抛出异常，这是该怎么做？本文通过示例代码介绍了详细的解决方法，有需要的朋友们可以参考借鉴，下面来一起看看吧。...2016-10-25利用Angular+Angular-Ui实现分页（代码加简单）
这篇文章主要介绍了利用Angular+Angular-Ui实现分页，利用Angular+Angular-Ui实现的分页分页代码更加简单，更加容易懂哦，相信本文的内容对大家具有一定的参考价值，需要的朋友们下面来一起看看吧。...2017-03-13- 这篇文章主要为大家简单介绍了Angular.js如何从PHP读取后台数据，本文将Angular和PHP相结合，从后台读取数据，感兴趣的小伙伴们可以参考一下...2016-03-28
Angular.js回顾ng-app和ng-model使用技巧
这篇文章主要回顾Angular.js中ng-app和ng-model使用技巧，感兴趣的小伙伴们可以参考一下...2016-04-27Angular.js中用ng-repeat-start实现自定义显示
大家都知道Angular.js可以用ng-repeat来显示列表数据，可是如果想要自定义显示数据列表的话ng-repeat就实现不了了，这个时候可以利用ng-repeat-start 和 ng-repeat-end来实现，下面通过本文来详细看看实现的方法吧。...2016-10-20