为什么 AngularJS 指令中不推荐使用 `replace` 属性？ [复制]

Question

根据the API docs，指令的replace 属性已被弃用，因此在未来，所有指令都将使用当前默认的replace: false。

这消除了开发人员替换元素指令的元素的能力，而没有明显替换此功能。

请参阅this plunk，了解元素指令在使用和不使用replace: true 的情况下如何工作的示例。

为什么这个有用的属性被弃用而没有替代品？

Answer 1

来自 GitHub：

Caitp-- 它已被弃用，因为replace: true 存在已知的非常愚蠢的问题，其中许多问题无法以合理的方式真正解决。如果您小心并避免这些问题，那么您将获得更多权力，但为了新用户的利益，告诉他们“这会让您头疼，不要这样做”会更容易。

-- AngularJS Issue #7636

replace:true 已弃用

来自文档：

replace（[已弃用！]，将在下一个主要版本中删除 - 即 v2.0）

指定模板应该替换的内容。默认为false。

• true - 模板将替换指令的元素。
• false - 模板将替换指令元素的内容。

-- AngularJS Comprehensive Directive API

另见 -- How to use the 'replace' feature for custom AngularJS directives?

Answer 2

我会说它已被删除是一件好事，因为它可以防止您将指令（组件）的内部工作原理暴露给外部世界。将您的模板视为一个影子 DOM，并将您的指令与普通的 HTML 元素（如按钮）进行比较。当您将鼠标悬停或单击它们时，您不会看到添加了所有类型的类以及将样式应用于这些元素。这一切都“隐藏”在里面。因为目前对 shadow DOM 的支持有些有限，所以它是一种解决方法，但它已经使您能够适应未来。

Answer 3

更新

其中一位合作者表示不会删除它，但不会修复已知的错误。 https://github.com/angular/angular.js/commit/eec6394a342fb92fba5270eee11c83f1d895e9fb#commitcomment-8124407

原创

这是此更改的提交： https://github.com/angular/angular.js/commit/eec6394a342fb92fba5270eee11c83f1d895e9fb

replace 标志用于定义替换元素的指令 它们所在的位置将在下一个主要角度版本中删除。 此功能具有困难的语义（例如属性如何合并） 与它解决的问题相比，会导致更多的问题。此外，与 WebComponents 在 DOM 中有自定义元素是很正常的。

在我看来，它是复杂性与维持支持的好处的结合。

显然，开发人员使用它的原因之一是他们更喜欢注入语义正确的标记，从而替换自定义指令标记。

---

阅读该链接下方的 cmets，显然很多人希望它保留。

Answer 4

如果您担心replace: true 会在下一个版本中被删除，您可以使用postCompile 函数来复制该行为。

/// Replace element with it's first child
Utils.replaceWithChild = function(element) {
    var child = angular.element(element[0].firstChild);
    Utils.mergeAttributes(element, child);
    element.replaceWith(child);
}

/// Copy attributes from sourceElement to targetElement, merging their values if the attribute is already present
Utils.mergeAttributes = function(sourceElement, targetElement) {
    var arr = sourceElement[0].attributes;
    for(var i = 0; i < arr.length; i++) {
        var item = arr[i];
        if(!item.specified)
            continue;

        var key = item.name;
        var sourceVal = item.value;
        var targetVal = targetElement.attr(key);

        if(sourceVal === targetVal)
            continue;

        var newVal = targetVal === undefined
            ? sourceVal
            : sourceVal + ' ' + targetVal;

        targetElement.attr(key, newVal);
    }
}

angular.module('test')
.directive('unwrap', function() {
    return {
        restrict: 'AE',
        templateUrl: 'unwrap.part.html',
        compile: function() {
            return function postCompile(scope, element, attr) {
                Utils.replaceWithChild(element);
            };
        }
    }; 
});