AngularJS自定义Directive初体验

 

通常我们这样定义个module并随之定义一个controller.

 

var app = angular.module('myApp', []);

app.controller('CustomersController', ['$scope', function($scope){
    var counter = 0;
    
    $scope.customer = {
        name:'',
        street:''
    };
    
    $scope.customers = [
        {
            name:'',
            street:''
        },
        ...
    ];
    
    $scope.addCustomer = function(){
        counter++;
        $scope.customers.push({
            name:'' + counter,
            street: coutner + ''
        });
        
        $scope.changeData = function(){
            counter++;
            $scope.customer = {
                name: '',
                street:counter + ''
            };
        }
    }
}]);

 


■ 使用ng-include引用子视图

在一个子视图中可以使用CustomersController,子视图的名称是:child.html

 

Name:{{customer.Name}}
Street:{{customer.street}}

然后在一个主视图中比如是index.html使用子视图:

<div ng-include="child.html"></div>

■ 初识自定义directive

如果使用自定义directive也可以做到。

 

angular.module('myApp').directive('myInfo', function(){
    return{
        template:'Name:{customer.name}<br/>Street:{{customer.street}}'
    };
})

 

在index.html主视图中可以这样使用自定义的directive。

<div my-info></div>

为什么myInfo到了视图中变成了my-info?这是一个惯例,比如我们经常用到的ng-repeat,在AngularJS中的源代码中是ngRepeat。还有,为什么,自定义的名称为myInfo的directive可以使用CustomersController的scope呢?因为主视图index.html中使用了CustomersController,而同在index.html视图中的<div my-info></div>共享了CustomersController的scope。

directive通常的用法包括如下:

 

angular.module('modulename')
    .directive('myDirective', function(){
        return {
            restrict: 'EA', //E表示element, A表示attribute,C表示class,M表示commnent,即注释
            scope:{
                title: '@' //@读属性值,=双向绑定,&用户函数
            }
            template: '<div>{{myVal}}</div>',
            templateUrl: 'app/sample.html',
            controller: 'myController',
            link:function($scope, element, attrs){}//DOM操作
        };
    })

 

■ 自定义direcitve操作DOM元素

 

app.directive('myDomDirective', function(){
    return {
        link: function($scope, ele, attrs){
            ele.bind('click', function(){
                ele.html('');
            });
            
            ele.bind('mouseenter', function(){
                ele.css('background-color','red');
            });
            
            ele.bind('mouseleave', function(){
                ele.css('background-color','white');
            });
        }
    };
});

 

在页面中这样使用:

<div my-dom-directive></div>

■ 封闭自定义directive的scope

默认情况下,自定义的directive的会共享父scope,但是,有时候我们希望自定义的directive的scope是封闭的、独立的,比如希望自定义的direcitve被用在多处。

只需要加上scope属性就好了,如下:

 

angular.module('myDirecitve', function(){
    return {
        scope:{},
        template: ''
    }
});

 

scope属性接受一个对象,在该对象中可以定义独立scope内的属性,而属性值的写法有三种,分别是@,=,&

● 使用@,外部scope赋值不影响封闭scope中的变量

 

angular.module('myApp').directive('myIsolateScopeWithName', function(){
    return {
        scope:{
            name: '@'
        },
        template: 'Name:{{name}}',
        controller: 'MyController'
    };
});

 

在封闭的scope中定义了一个name变量,占位符@表示这里接受一个值。

如何给这里的变量赋值呢?

一种是把name成为一个属性来接收值:

<div my-isolated-scope-with-name name="{{ customer.name }}"></div>

一种是在MyController中给name赋值:

$scope.name = '';

如果把name="{{ customer.name }}"改成myname="{{ customer.name }}"呢?

那就需要这样定义:

angular.module('myApp').directive('myIsolateScopeWithName', function(){
    return {
        scope:{
            name: '@myname'
        },
        template: 'Name:{{name}}',
        controller: 'MyController'
    };
});

 

● 使用=,外部scope赋值会影响封闭scope中的变量

 

angular.module('myApp').directive('myIsolateScopeWithEqual', function(){
    return {
        scope:{
            customer: '='
        },
        template: '<ul><li ng-repeate="prop in customer">{{prop}}</li></ul>'
    };
});

 

注意,这里的customer是作为变量在使用,而不是{{customer}},一旦外部的赋值发生变化会影响独立scope中的customer变量值。同样,一旦独立scope中的customer值发生变化,也会影响外部的scope的customer属性值。

外部这样使用:

<div my-isolated-scope-with-equal customer="customer"></div>


● 使用&,允许外部scope传递一个函数给封闭scope

 

angular.module('myApp').directive('myIsolateScopeWithFunction', function(){
    return {
        scope: {
            datasource: '=',
            action:'&'
        },
        template: '<ul><li ng-repeat="prop in datasource">{{ prop }}</li></ul> ' + '<button ng-click="action()">Change Data</button>'
    };
});

 

这样使用这个directive

 

<div my-isolated-scope-with-function 
     datasource="customer" 
     action="changeData()">
</div>

 

changeData方法被定义在了controller里面:

 

$scope.changeData = function () {
      counter++;
      $scope.customer = {
          name: 'James',
          street: counter + ' Cedar Point St.'
      };
};

 

如何让外部scope传递一个带参函数给封闭scope呢?

 

angular.module('directivesModule').directive('isolatedScopeWithController', function () {
    return {
        restrict: 'EA',
        scope: {
            datasource: '=',
            add: '&',
        },
        controller: function ($scope) {
            ...

           
            $scope.addCustomer = function () {
                //Call external scope's function
                var name = 'New Customer Added by Directive';
                $scope.add({ name: name });

                //Add new customer to directive scope
                $scope.customers.push({
                    name: name,
                    street: counter + ' Main St.'
                });
            };
        },
        template: '<button ng-click="addCustomer()">Change Data</button>' +
                  '<ul><li ng-repeat="cust in customers">{{ cust.name }}</li></ul>'
    };
});

 

在页面中这样调用:


<div isolated-scope-with-controller datasource="customers" add="addCustomer(name)"></div>

■ 允许自定义的direcitve被嵌套


只要把tranclude设置成true就可以。

 

"use strict";

angular.module("psFramework").directive("psFramework",function(){
    return {
        transclude: true,
        scope:{
            title: '@',
            subtitle:'@',
            iconFile:'@'
        },
        controller: "psFrameworkController",
        templateUrl: "ext-modules/psFramework/psFrameworkTemplate.html"
    };
})

 

然后在页面中就可以这样使用:

 

<ps-framework title="", subtile="", icon-file="">
    <ps-menu>
        ...
    </ps-menu>
</ps-framework>

 

参考:https://weblogs.asp.net/dwahlin/

 

posted @ 2015-11-18 17:56  Darren Ji  阅读(4537)  评论(0编辑  收藏  举报

我的公众号:新语新世界,欢迎关注。