碼上快樂

相關內容    簡體    繁體

AngularJS之指令

本文轉載自   查看原文   2016-08-10 20:52   1390    AngularJS/ Angular1.x

緊接上篇博客“初探AngularJS”

一、前言

在AngularJS中指令尤為重要且內容龐多，固單獨提煉出來，梳理一番。如有錯誤，請不吝講解。

好了，言歸正傳，讓我們一起走進Angular指令的世界。

在上篇博客的前言部分提到，Angular的核心就是對HTML標簽的增強。我們用到的諸如ng-app、ng-controller等等這些都是屬於Angular指令，具體點，它們為Angular內置的指令。

Angular不僅提供了內置指令，它還允許我們自定義指令，不然Angular就太low咯。

這也是本篇博客的核心：如何自定義指令。

該篇博客原文地址：http://www.cnblogs.com/giggle/p/5746220.html

二、自定義指令

Angular為我們提供了.directive()這個方法，來定義指令。

如下：

正如上述代碼所示，directive方法接受兩個參數：name和factory_function。

　　--name嘛，即為指令的名字，供我們調用時使用；

　　--factory_function就是當我們調用指令時，指令的實際行為，並且factory_function通常返回一個對象，里面通過規定的設置項來定義指令。

那么自定義指令中，我們都可以操作哪些設置項呢？

如下：

var app = angular.module('myApp', []);
app.directive('myDirective', function(){
            
    return {
        restrict: 'EACM',//告訴AngularJS這個指令在DOM中以何種形式被聲明，默認為A
        priority: Number,//優先級參數（值為數值），數值越大，優先級越高，默認為0
        terminal: Boolean,//true或者false，告訴AngularJS是(true)否(false)停止運行當前元素上比本指令優先級低的指令
        template: String or Template Function,//模板
        templateUrl: String,//模板URL
        replace: Boolean,//值為true,代表模板會替換掉調用該指令的元素
        scope: Boolean or Object,//指令作用域
        transclude: Boolean,//true,結合ng-transclude，在該指令中嵌入內容
        controller: String or function($scope, $element, $attrs, $transclude, otherInjectables){...},//指令控制器
        controllerAs: String,//用來設置控制器的別名
        require: String,//將控制器注入到其值所指定的指令中
        link: function(scope, element, attrs){...},
        compile: function(){}               
    };
});
代碼稍長，請自行打開

針對如此眾多的設置項，我們一同先挑幾個常用且簡單的設置項，感受感受吧。

--template & templateUrl--

template模板參數是可選的，其值可以是一段HTML文本，也可以是一個接受兩個參數的函數。

注：如果template值為空，或者沒有template設置項，那么不會覆蓋嵌入在指令內部的元素，且當指令scope為false或者{…}時，內部元素的作用域共享外部父作用域；但，當指令scope為true時，內部元素的作用域就是繼承自外部父作用域。

demo如下：

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myModule">
        outterDirective:<input type="text" ng-model="name"/><br>
        <one>
            innerDirective: <input type="text" ng-model="name"/>
        </one>
        <script src="angular.js"></script>
        <script>
            var myModule = angular.module('myModule', []);
            myModule.directive('one', function(){
                return {
                    scope: false,
                    restrict: 'E'
                }
            });
        </script>
    </body>
</html>
scope為false

效果圖如下：

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myModule">
        outterDirective:<input type="text" ng-model="name"/><br>
        <one>
            innerDirective: <input type="text" ng-model="name"/>
        </one>
        <script src="angular.js"></script>
        <script>
            var myModule = angular.module('myModule', []);
            myModule.directive('one', function(){
                return {
                    scope: {},
                    restrict: 'E'
                }
            });
        </script>
    </body>
</html>
scope為{...}

scope:{...}效果同上

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myModule">
        outterDirective:<input type="text" ng-model="name"/><br>
        <one>
            innerDirective: <input type="text" ng-model="name"/>
        </one>
        <script src="angular.js"></script>
        <script>
            var myModule = angular.module('myModule', []);
            myModule.directive('one', function(){
                return {
                    scope: true,
                    restrict: 'E'
                }
            });
        </script>
    </body>
</html>
scope為true

scope為true，效果圖如下：

 

假設，設置了template后，當我們調用指令后，它會呈現在頁面中。下面我們就來具體看看。

1、當template值為一段HTML文本時，demo如下：

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
        <div my-directive></div>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('myDirective', function(){
                return {
                    template: '<div>\
                                   <h1>Hi everyone!</h1>\
                               </div>'
                };
            });
        </script>
    </body>
</html>
EntireCode

2、當template值為函數時，demo如下：

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
        <div my-directive title="Monkey"></div>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('myDirective', function(){
                return {
                    /*
                        值為函數時，接受兩個參數tElement, tAttrs:
                            tElement:使用此指令的元素
                            tAttrs:實例的屬性，它是一個由元素上所有的屬性組成的集合，即對象
                    */
                    template: function(tElement, tAttrs){
                        var _html = '';
                        _html +='<div>' + 'Hi,'+tAttrs.title+'</div>';
                        return _html;
                    }
                };
            });
        </script>
    </body>
</html>
代碼稍長，請自行打開

利用template可以在指令中自定義我們需要的模板，但是隨着模板的體積（代碼量）不斷變大時，在指令中利用template就顯得很糟糕，故而，使用templateUrl引用外部模板，是更好的選擇。

--restrict--

restrict 是一個可選參數，它告訴AngularJS這個指令在DOM中以何種形式被調用。一共有四個選擇且都為大寫，不然沒效果，默認為A（屬性）。

A（屬性）：

<div my-directive></div>

E（元素）：

<my-directive></my-directive>

C（類名）：

<div class="my-directive"></div>

M（注釋）：

//以注釋調用指令時，前后得有空格
<!-- directive:my-directive -->

這四個選項，可以單獨使用，亦可混合使用。如：

restrict: ‘EA’就代表可以用元素或者屬性調用指令

--replace--

replace是一個可選參數，值為Boolean類型，默認為false，代表模板會被當作子元素插入到調用此指令的元素內部。

如下：

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
        <div my-directive></div>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('myDirective', function(){
                return {
                    replace: false,
                    template: '<div>Monkey</div>'
                };
            });
        </script>
    </body>
</html>
代碼稍長，請自行打開

運行后，打開chrome調試器，結果如下：

 

--replace值為true，即模板會替換掉調用指令的元素，如下：

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
        <div my-directive></div>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('myDirective', function(){
                return {
                    replace: true,
                    template: '<div>Monkey</div>'
                };
            });
        </script>
    </body>
</html>
代碼稍長，請自行打開

運行后，打開chrome調試器，結果如下：

 

且，當值為true時，template會替代調用指令的元素，固template中的值，必須只包含一個根節點，不然會報錯，如下：

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
        <div my-directive></div>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('myDirective', function(){
                return {
                    replace: true,
                    template: '<div>Monkey</div><h1>Dorie</h1>'
                };
            });
        </script>
    </body>
</html>
代碼稍長，請自行打開

運行后，打開chrome調試器，報錯如下：

--transclude--

transclude是一個可選參數，表示是否允許在指令中，嵌入內容。值為Boolean，默認值為false代表不允許在指令中嵌入內容，如果手動設置為true后，要結合ng-transclude指令使用，不然和false效果一樣。

下面我們一起來編寫兩個demo具體看看。

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
        <div my-directive>
            <span>需要嵌入內容</span>
        </div>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('myDirective', function(){
                return {
                    transclude: false,
                    template: '<div>指令內容</div>'
                };
            });
        </script>
    </body>
</html>
transclude為false

運行代碼，打開chrome調試器得下：

我們再來看看transclude:true的情況，將上述代碼中的transclude的值改為true后，運行代碼。

咦，我靠和上訴transclude:false的結果一樣呢？

哦，對了，雖然我們將transclude的值設為true了，但是要結合ng-transclude指令嘛，不然，你讓人家嵌入內容往哪插呢？

利用ng-transclude指令修改代碼后，得下：

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
        <div my-directive>
            <span>需要嵌入內容</span>
        </div>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('myDirective', function(){
                return {
                    transclude: true,
                    template: '<div>指令內容</div><div ng-transclude></div>'
                };
            });
        </script>
    </body>
</html>
代碼稍長，請自行打開

運行代碼，打開chrome調試器，得下：

 

注：利用ng-transclude指令標記的元素中，不管有沒有內容，都將等同於無內容情況。

咦，利用transclude嵌入的內容，它們有自己的作用域嗎？如果有，那么它們的作用域繼承誰呢，指令or外部作用域？

答案：利用ng-transclude嵌入的內容的同時，會創建一個屬於自己的作用域，即子作用域，且繼承自外部作用域，並非指令。

--scope--

scope參數是可選的，它是直接影響指令的作用域。該參數可以被設置為不同的三個值，分別代表三種不同的作用域，下面我們就來一一說明。

1、scope: false

當scope的值為false時，也就是默認狀態，代表指令共享父作用域，即沒有自己的作用域。

如下：

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
        Parent:<input type="text" ng-model="name"/>
        <directive-for-false></directive-for-false>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('directiveForFalse', function(){
                return {
                    restrict: 'E',
                    scope: false,
                    template: '<div>Child: \
                                  <input type="text" ng-model="name">\
                               </div>'
                };
            });
        </script>
    </body>
</html>
代碼稍長，請自行打開

執行上述代碼，效果圖如下：

 

2、scope: true

當scope的值為true時，代表指令會創建自己的作用域，且繼承自父作用域。

如下：

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
        Parent:<input type="text" ng-model="name"/>
        <directive-for-true></directive-for-true>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('directiveForTrue', function(){
                return {
                    restrict: 'E',
                    scope: true,
                    template: '<div>Child: \
                                  <input type="text" ng-model="name">\
                               </div>'
                };
            });
        </script>
    </body>
</html>
代碼稍長，請自行打開

執行上述代碼，效果圖如下：

3、scope: {…}

當scope的值為對象時，代表指令會切斷與外界的聯系，創建一個隔離的作用域，既不繼承於父作用域，也不准內嵌的指令繼承於自己。

一起寫個demo，感受下“隔離作用域”不繼承於父作用域，如下：

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
        Parent:<input type="text" ng-model="name"/>
        <directive-for-obj></directive-for-obj>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('directiveForObj', function(){
                return {
                    restrict: 'E',
                    scope: {},
                    template: '<div>Child: \
                                  <input type="text" ng-model="name">\
                               </div>'
                };
            });
        </script>
    </body>
</html>
代碼稍長，請自行打開

執行上述代碼，效果圖如下：

  

至於“不准內嵌的指令繼承於自己”，參考上面的--transclude--

那當我們將scope設置為對象后，就成了一個無人問津的作用域，這樣非常適合我們寫插件之類的，但，怎么與外界交互呢？

這就涉及到所謂的綁定策略啦。

如下：

       scope的綁定策略

@

把當前屬性作為字符串傳遞。你還可以綁定來自外層scope的值，在屬性值中插入{{ }}即可。

=

與父scope中的屬性進行雙向綁定。

&

傳遞一個來自父scope的函數

下面，我們就針對上面的提示，逐個demo，感受體會下。

1、@策略

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
    
        <input type="text" ng-model="name"/>
        
        <directive-for-obj who="{{name}}" love="love Dorie"></directive-for-obj>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('directiveForObj', function(){
                return {
                    restrict: 'E',
                    scope: {
                        who:'@',
                        what: '@love'
                    },
                    template: '<div><input type="text" ng-model="who"/> {{what}}</div>'
                };
            });
        </script>
    </body>
</html>
代碼稍長，請自行打開

效果圖，如下：

 

2、=策略

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
    
        <input type="text" ng-model="name"/>
        
        <directive-for-obj who="name" love="love Dorie"></directive-for-obj>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.directive('directiveForObj', function(){
                return {
                    restrict: 'E',
                    scope: {
                        who:'=',
                        what: '@love'
                    },
                    template: '<div><input type="text" ng-model="who"/> {{what}}</div>'
                };
            });
        </script>
    </body>
</html>
代碼稍長，請自行打開

效果圖，如下：

3、&策略 

   

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
    </head>
    <body ng-app="myApp">
    
        <input type="text" ng-model="name"/>
        
        <directive-for-obj who="name" love="love Dorie" greet="sayWhat(wt, whr)"></directive-for-obj>
        <script src="angular.js"></script>
        <script>
            var app = angular.module('myApp', []);
            app.run(function($rootScope){
                $rootScope.sayWhat = function(what, where){
                    alert('hello, '+what+' at '+where);
                }
            });
            app.directive('directiveForObj', function(){
                return {
                    restrict: 'E',
                    scope: {
                        who:'=',
                        what: '@love',
                        greet: '&'
                    },
                    template: '<div><input type="text" ng-model="who"/> {{what}}</div>\
                                <button ng-click="greet({wt: who, whr: who})">click</button>'
                };
            });
        </script>
    </body>
</html>
EntireCode

--controller--

controller參數可以是一個字符串或一個函數。

注：當設置為字符串時，會以該字符串的值為名字，到注冊在應用中的控制器中查找，不管該指令的scope值是什么，如果應用中的控制器沒有對應的控制器，則報錯。

在控制器中，是的，控制器，包括了指令以及注冊在應用中的，可以注入一些特殊的服務，供其使用，如下：

$scope

與指令元素相關聯的當前作用域

$element

當前指令對應的元素

$attrs

當前元素的屬性組成的對象，如：

<div id=”nav” name=”Monkey”></div>

屬性對象為：

{

id:  ‘nav’,

name:  ‘Monkey’

}

並且，指令之間的控制器（controller）可以復用。

怎么復用呢？

這就需要結合下面將要介紹的require設置項啦。

--require--

require參數可以被設置為字符串或數組，字符串代表另外一個指令的名字。Require會將控制器注入到其值所指定的指令中，並作為當前指令的鏈接函數（link）的第四個參數。用法如下：

沒有前綴

指令會在自身提供的控制器中進行查找，如果找不到任何控制器，則會拋出一個error

?

如果在當前的指令沒有找到所需的控制器，則會將null傳給link連接函數的第四個參數

^

如果在當前的指令沒有找到所需的控制器，則會查找父元素的控制器

?^

綜合前面?和^


免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。



猜您在找 指令 【AngularJS】—— 10 指令的復用 angularjs 指令—— 綁定策略（@、=、&） angularJs指令深度分析 AngularJS指令參數詳解 【AngularJS】—— 11 指令的交互 AngularJS 指令之 ng-if AngularJS幾個常用指令 AngularJs 內置指令 Angularjs: 封裝layDate指令
 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM