根据文档,template
可以是一个函数,它接受两个参数element
和attributes
,并返回表示模板的字符串值。它用HTML的内容替换当前元素。替换过程将所有属性和类从旧元素迁移到新元素。
compile
函数处理转换模板DOM。它需要三个参数,element
,attributes
和transclude
函数。不推荐使用transclude
参数。它返回link
函数。
似乎template
和compile
函数非常相似,可以实现相同的功能。 template
函数定义模板,compile
函数修改模板DOM。但是,它可以在template
函数本身中完成。我无法理解为什么在template
函数之外修改模板DOM。反之亦然,如果可以在compile
函数中修改DOM,那么template
函数的需求是什么?
答案 0 :(得分:50)
编译功能可用于在结果模板函数绑定到范围之前更改DOM。
考虑以下示例:
<div my-directive></div>
您可以使用compile函数更改模板DOM,如下所示:
app.directive('myDirective', function(){
return {
// Compile function acts on template DOM
// This happens before it is bound to the scope, so that is why no scope
// is injected
compile: function(tElem, tAttrs){
// This will change the markup before it is passed to the link function
// and the "another-directive" directive will also be processed by Angular
tElem.append('<div another-directive></div>');
// Link function acts on instance, not on template and is passed the scope
// to generate a dynamic view
return function(scope, iElem, iAttrs){
// When trying to add the same markup here, Angular will no longer
// process the "another-directive" directive since the compilation is
// already done and we're merely linking with the scope here
iElem.append('<div another-directive></div>');
}
}
}
});
因此,如果您的指令需要,您可以使用compile
函数将模板DOM更改为您喜欢的任何内容。
在大多数情况下,tElem
和iElem
将是相同的DOM元素,但如果指令克隆模板以删除多个副本,有时它可能会有所不同(参见ngRepeat
)
在幕后,Angular使用双向渲染过程(编译+链接)来删除已编译的DOM片段的副本,以防止Angular不得不一遍又一遍地处理(=解析指令)相同的DOM对于每个实例,如果该指令标记出多个克隆,从而产生更好的性能。
希望有所帮助!
评论后添加:
template
和compile
函数之间的差异:
{
template: function(tElem, tAttrs){
// Generate string content that will be used by the template
// function to replace the innerHTML with or replace the
// complete markup with in case of 'replace:true'
return 'string to use as template';
}
}
{
compile: function(tElem, tAttrs){
// Manipulate DOM of the element yourself
// and return linking function
return linkFn(){};
}
}
在调用compile函数之前调用模板函数。
虽然它们可以执行几乎相同的东西并共享相同的“签名”,但关键的区别在于模板函数的返回值将替换指令的内容(如果replace: true
,则替换完整的指令标记) ,编译函数应该以编程方式更改DOM并返回链接函数(或具有前后链接功能的对象)。
从这个意义上说,如果只需要用字符串值替换内容,就可以将模板函数视为某种便利函数,而不必使用编译函数。
希望有所帮助!
答案 1 :(得分:6)
模板功能的最佳用途之一是有条件地生成模板。这允许您基于属性或任何其他条件自动创建模板。
我见过一些非常大的模板,它们使用ng-if
来隐藏模板的各个部分。但是,不是将所有内容放入模板并使用ng-if
,这可能导致过度绑定,您可以从模板函数的输出中删除不会被使用的DOM部分。
假设您有一个指令,其中包含子指令item-first
或item-second
。并且子指令永远不会改变外部指令的生命周期。在调用编译函数之前,您可以调整模板的输出。
<my-item data-type="first"></my-item>
<my-item data-type="second"></my-item>
这些的模板字符串是:
<div>
<item-first></item-first>
</div>
和
<div>
<item-second></item-second>
</div>
我同意这是一个极端简化,但我有一些非常复杂的指令,外部指令需要根据类型显示一个,大约20个不同的内部指令。我可以在外部指令上设置类型,并让模板函数使用正确的内部指令生成正确的模板,而不是使用transclude。
然后将格式正确的模板字符串传递给编译函数等