AngularJS指令开发（1）——参数详解

Angularjs 前端之家
前端之家收集整理的这篇文章主要介绍了AngularJS指令开发（1）——参数详解，前端之家小编觉得挺不错的，现在分享给大家，也给大家做个参考。

指令，很重要

AngularJS与JQuery最大的区别在哪里？我认为，表现在数据双向绑定，实质就是DOM的操作形式不一样。

  • JQuery通过选择器找到DOM元素，再赋予@H_403_8@元素的行为；

  • 而AngularJS则是，将指令与DOM绑定在一起，再扩展@H_403_8@指令的行为。

所以AngularJS开发最理想的结果就是，在页面HTML与CSS的设计时，设计工程师只需要关注指令的使用；而在背后的逻辑开发上，架构工程师则是不需要知道如何操作DOM，只需要关注指令背后的行为要如何实现就行；测试工程师也可以开发针对指令的单元测试。

指令就是DOM与逻辑行为的媒介，本质就是DOM绑定的独立逻辑行为函数。@H_403_8@@H_403_8@

指令难点在于参数

来看看都有哪些

angular.module('app'@H_403_8@,[])
.directive('myDirective'@H_403_8@,function@H_403_8@()@H_403_8@ @H_403_8@{
    return@H_403_8@ {
    restrict: String@H_403_8@,priority: Number@H_403_8@,terminal: Boolean@H_403_8@,template: String@H_403_8@ or Template Function@H_403_8@:
    function@H_403_8@(tElement,tAttrs)@H_403_8@ @H_403_8@{...},templateUrl: Boolean@H_403_8@ or Object@H_403_8@,transclude: String@H_403_8@ or
    function@H_403_8@(scope,element,attrs,transclude,otherInjectables)@H_403_8@ @H_403_8@{ ... },controllerAs: require@H_403_8@: 403_8@ @H_403_8@{ ... },compile: // 返回一个对象或连接函数，如下所示：@H_403_8@
    403_8@ @H_403_8@{
        return@H_403_8@ {
            pre: 403_8@ @H_403_8@{ ... },post: 403_8@ @H_403_8@{ ... }
           }
        return@H_403_8@ function@H_403_8@ postLink@H_403_8@(...)@H_403_8@ @H_403_8@{ ... }
        }
    };
 });

刚开始接触指令的时候，我简直就是蒙了，这堆参数究竟怎么用怎么理解啊。告诉大家我的一个理解方法。
把它们分成三类：

  1. 描述指令或DOM本身特性@H_403_8@的内部参数

  2. 连接@H_403_8@指令外界、与其他指令或控制器沟通的对外参数

  3. 描述指令本身行为@H_403_8@的行为参数

内部参数

  • restrict@H_403_8@：String，E（元素）<my-directive></my-directive>A（属性，默认值）<div my-directive="expression"></div>C（类名）<div class="my-directive:expression;"></div>M（注释）<--directive:my-directive expression-->

  • priority@H_403_8@: Number，指令执行优先级

  • template@H_403_8@: String，指令链接DOM模板，例如“<h1>{{head}}</h1>”

  • templateUrl@H_403_8@:String，DOM模板路径

  • replace@H_403_8@: Boolean，指令链接模板是否替换原有元素，

对外参数——scope

scope参数非常重要，本应该是放到最后说明的，但是scope却是理解其他参数的关键，所以务必先跟大家说清楚。

scope参数的作用是，隔离指令与所在控制器间的作用域、隔离指令与指令间的作用域。

scope参数是可选的，默认值为false，可选true、对象{}；

  • false：共享父域

  • true：继承父域，且新建独立作用域

  • 对象{}：不继承父域，且新建独立作用域

false、true、{}三者对比

来看个例子

<body@H_403_8@>@H_403_8@
    <div@H_403_8@ ng-controller@H_403_8@='parentCtrl'@H_403_8@>@H_403_8@
        <h3@H_403_8@>@H_403_8@指令scope参数——false、true、{}对比测试</h3@H_403_8@>@H_403_8@
        parent:
        <div@H_403_8@>@H_403_8@
            <span@H_403_8@>@H_403_8@ {{parentName}}</span@H_403_8@>@H_403_8@
            <input@H_403_8@ type@H_403_8@="text"@H_403_8@ ng-model@H_403_8@="parentName"@H_403_8@ />@H_403_8@
        </div@H_403_8@>@H_403_8@
        <br@H_403_8@ />@H_403_8@
        <child-a@H_403_8@>@H_403_8@</child-a@H_403_8@>@H_403_8@
        <child-b@H_403_8@>@H_403_8@</child-b@H_403_8@>@H_403_8@
        <child-c@H_403_8@ parent-name@H_403_8@="parentName"@H_403_8@>@H_403_8@</child-c@H_403_8@>@H_403_8@
    </div@H_403_8@>@H_403_8@
    <!--t1指令模板-->@H_403_8@
    <script@H_403_8@ "text/html"@H_403_8@ id@H_403_8@="t1"@H_403_8@>@H_403_8@ <div> <span@H_403_8@>@H_403_8@{{parentName}}</span@H_403_8@>@H_403_8@ <"parentName"@H_403_8@ />@H_403_8@ </div@H_403_8@>@H_403_8@ @H_403_8@@H_403_8@</script@H_403_8@>@H_403_8@
    <script@H_403_8@>@H_403_8@ var@H_403_8@ app = angular.module("app"@H_403_8@,[]); app.controller('parentCtrl'@H_403_8@,0)">function@H_403_8@ ($scope)@H_403_8@ @H_403_8@{ $scope.parentName = "parent"@H_403_8@; }) //false：共享作用域@H_403_8@ app.directive('childA'@H_403_8@,0)">function@H_403_8@ ()@H_403_8@ @H_403_8@{ return@H_403_8@ { restrict: 'E'@H_403_8@,scope: false@H_403_8@,template: function@H_403_8@ (elem,attr)@H_403_8@ @H_403_8@{ return@H_403_8@ "false:"@H_403_8@ + document@H_403_8@.getElementById('t1'@H_403_8@).innerHTML; } }; }); //true：继承父域，并建立独立作用域@H_403_8@ app.directive('childB'@H_403_8@,scope: true@H_403_8@,152)">"true:"@H_403_8@ + 't1'@H_403_8@).innerHTML; },controller: "parent"@H_403_8@; //已声明的情况下，$scope.$watch监听的是自己的parentName@H_403_8@ $scope.$watch('parentName'@H_403_8@,0)">function@H_403_8@ (n,o)@H_403_8@ @H_403_8@{ console@H_403_8@.log("child watch"@H_403_8@ + n); }); //$scope.$parent.$watch监听的是父域的parentName@H_403_8@ $scope.$parent.$watch("parent watch"@H_403_8@ + n); }); } }; }); //{}：不继承父域，建立独立作用域@H_403_8@ app.directive('childC'@H_403_8@,scope: {},152)">"{}:"@H_403_8@ + function@H_403_8@ ($scope)@H_403_8@ @H_403_8@{ console@H_403_8@.log($scope); } }; }); @H_403_8@</script@H_403_8@>@H_403_8@
</body@H_403_8@>@H_403_8@

false参数

本质@H_403_8@：子域与父域共享作用域。
特点@H_403_8@：父域修改parentName的同时，指令绑定的parentName的元素会被刷新。

反之，指令内部parentName被修改时，父域的parentName同样会被刷新。

true参数

本质：@H_403_8@子域继承父域，并建立独立作用域。
特点：@H_403_8@

1、在指令已声明parentName的情况下，父域parentName变更，指令中parentName不会发生变化。
指令在true参数下，建立了的scope，独立并隔离与父控制器的scope。@H_403_8@

controller: function@H_403_8@ ($scope@H_403_8@)@H_403_8@ @H_403_8@{
    $scope@H_403_8@.parentName = "parent"@H_403_8@;
}

反之，指令中parentName变更，父域也不会发生变化。

2、在指令未声明parentName的情况下，父域的parentName变更，指令中parentName也会刷新
这种情况很多时候会被忽略，指令的scope没有声明对象时，其元素绑定的仍然是父域的对象。但，一旦指令中Input变更了，对应的独立scope也会自动声明该绑定对象，这就回到了第1种情况。@H_403_8@

$scope@H_403_8@)@H_403_8@ @H_403_8@{
    //$scope.parentName = "parent";@H_403_8@
}

然而，指令中parentName变更，父域是不会变化的；

3、在指令已声明parentName的情况下 ，在指令中监听父域parentName 的变化无效。但监听子域parentName的变化有效
独立子域scope，只能监听自己的，不能监听父域的。但通过 $scope.$parent可以监听父域。@H_403_8@

"parent"@H_403_8@ ;

    //已声明的情况下，$scope.$watch监听的是自己的parentName@H_403_8@
    $scope@H_403_8@.$watch@H_403_8@( 403_8@ @H_403_8@{
        console.log("child watch"@H_403_8@ + n);
    });

    //$scope.$parent.$watch监听的是父域的parentName@H_403_8@
    $parent@H_403_8@."parent watch"@H_403_8@ + n);
    });
}

4、在指令未声明parentName的情况下 ，在指令中监听父域parentName的变化有效。
这里就不解释了，参考第2点，大家可以动手试一下。@H_403_8@

//$scope.parentName = "parent";@H_403_8@

    //未声明的情况下，$scope.$watch监听的是父域的parentName@H_403_8@
    $watch@H_403_8@("child watch"@H_403_8@ + n);
    });
}

对象{}参数

本质：@H_403_8@子域不继承父域，并建立独立作用域。
特点：@H_403_8@

1、当scope对象为空对象时，无论是父域parentName，还是指令子域parentName发生变更，都不会影响到对方。
原理很清楚，就是指令建立的独立作用域，与父域是完全隔离的。

@H_403_8@scope@H_403_8@: {}@H_403_8@

2、当scope对象为非空对象时，指令会将该对象处理成子域scope的扩展属性。而父域与子域之间传递数据的任务，就是可以通过这块扩展属性完成。

'parentCtrl'@H_403_8@>@H_403_8@
    parent:
    <p@H_403_8@>@H_403_8@<span@H_403_8@>@H_403_8@{{name}}</span@H_403_8@>@H_403_8@<"name"@H_403_8@ />@H_403_8@</p@H_403_8@>@H_403_8@
    <span@H_403_8@>@H_403_8@{{sexy}}</"sexy"@H_403_8@ />@H_403_8@</span@H_403_8@>@H_403_8@{{age}}</"age"@H_403_8@ />@H_403_8@</br@H_403_8@ />@H_403_8@

    <!--特别注意：@与=对应的attr，@是单向绑定父域的机制，记得加上{{}}；&对应的attrName必须以on-开头-->@H_403_8@
    <my-name@H_403_8@="name"@H_403_8@ my-sexy-attr@H_403_8@="sexy"@H_403_8@ my-age@H_403_8@="{{age}}"@H_403_8@ on-say@H_403_8@="say('i m ' + name)"@H_403_8@>@H_403_8@</child-c@H_403_8@>@H_403_8@
</div@H_403_8@>@H_403_8@

<!--t1指令模板-->@H_403_8@
<span@H_403_8@>@H_403_8@{{myName}}</"myName"@H_403_8@ />@H_403_8@ </div@H_403_8@>@H_403_8@ <span@H_403_8@>@H_403_8@{{mySexy}}</"mySexy"@H_403_8@ />@H_403_8@ </span@H_403_8@>@H_403_8@{{myAge}}</"myAge"@H_403_8@ />@H_403_8@ </script@H_403_8@>@H_403_8@

<function@H_403_8@ ($scope)@H_403_8@ @H_403_8@{ $scope.name = "mark"@H_403_8@; $scope.sexy = "male"@H_403_8@; $scope.age = "30"@H_403_8@; $scope.say = function@H_403_8@ (sth)@H_403_8@ @H_403_8@{ alert(sth); }; }) app.directive('='@H_403_8@,mySexy: '=mySexyAttr'@H_403_8@,myAge: '@'@H_403_8@,onSay: '&'@H_403_8@ },210)">console@H_403_8@.log($scope.myName); console@H_403_8@.log($scope.mySexy); console@H_403_8@.log($scope.myAge); $scope.onSay(); } }; }); @H_403_8@</script@H_403_8@>@H_403_8@

@（or @Attr）@H_403_8@绑定策略——本地作用域属性，使用@符号将本地作用域同DOM属性的值进行绑定。指令内部作用域可以使用外部作用域的变量。（单向引用父域对象）@H_403_8@

"{{age}}"@H_403_8@>@H_403_8@</child-c@H_403_8@>@H_403_8@

ps：@@H_403_8@是单向绑定本地作用域，记得加上{{}}

scope@H_403_8@: { myAge@H_403_8@: '@'@H_403_8@,@H_403_8@@H_403_8@@H_403_8@}

= （or =Attr）@H_403_8@绑定策略——双向绑定：通过=@H_403_8@可以将本地作用域上的属性同父级作用域上的属性进行双向的数据绑定。就像普通的数据绑定一样，本地属性会反映出父数据模型中所发生的改变。（双向引用父域对象）@H_403_8@

onSay@H_403_8@="name"@H_403_8@>@H_403_8@</ ps：=@H_403_8@策略不需要@H_403_8@加上{{}}进行绑定
 

myName@H_403_8@: '='@H_403_8@,sans-serif; font-size:14px; line-height:22.4px; widows:1"> & （or &Attr）@H_403_8@绑定策略——通过&符号可以对父级作用域进行绑定，以便在其中运行函数。（调用父域函数）@H_403_8@
 

 ps：&@H_403_8@对应的attrName必须以on-开头
 

onSay@H_403_8@: '&'@H_403_8@,sans-serif; font-size:14px; line-height:22.4px; widows:1"> 父域绑定调用函数及传参
 

app.controller($scope@H_403_8@)@H_403_8@ @H_403_8@{
     $scope@H_403_8@.say = function@H_403_8@ (sth)@H_403_8@ @H_403_8@{
         alert(sth);
     };
})
 

 ps特别注意：@@H_403_8@与=@H_403_8@对应的attr，；
 

<child-c my@H_403_8@-name="name"@H_403_8@ my@H_403_8@-sexy-attr="sexy"@H_403_8@ my@H_403_8@-age="{{age}}"@H_403_8@ on-say@H_403_8@="say('i m ' + name)"@H_403_8@></child-c> @H_403_8@
 

 总结下来，scope扩展对象，既能够解耦父域与子域共域的问题，也能够实现指令与外界通讯的问题，是Angular开发指令化模块化的重要基础。在往后的章节，我会向大家介绍指令化开发的更多实例。
 

 对外参数——require
 

 scope是指令与外界作用域通讯的桥梁，而require是指令与指令之间通讯的桥梁。这个参数最大的作用在于，当要开发单指令无法完成，需要一些组合型指令的控件或功能，例如日期控件，通过require参数，指令可以获得外部其他指令的控制器，从而达到交换数据、事件分发的目的。
 

 使用方法：require: String or Array——String值为引入指令名称，并且有两个寻找指令策略符号‘？@H_403_8@’与‘^@H_403_8@’；Array数组则为多个外部指令名称。
 

 在link函数第4个参数ctrl中获取注入外部指令的控制器，如果require为String，ctrl为对象，如果require是数组，ctrl为数组。
 

require@H_403_8@: '^teacher1'@H_403_8@,0)">$scope@H_403_8@,$element@H_403_8@,0)">$attrs@H_403_8@,ctrl)@H_403_8@ @H_403_8@{
    //ctrl指向teacher1指令的控制器@H_403_8@
}
 

 ？@H_403_8@策略——寻找指令名称，如果没有找到，link函数第4个参数为null；如果没有？，则报错。
 

 ^@H_403_8@策略——在自身指令寻找指令名称的同时，向上父元素寻找；如果没有^，则仅在自身寻找。
 如下例子，指令studentA向上可以找到指令teacher及自身，但是不能找到相邻兄弟的student-b。
 

<div teacher>@H_403_8@
    <student-a>@H_403_8@</student-a>@H_403_8@
    <student-b>@H_403_8@</student-b>@H_403_8@
</div>@H_403_8@
 

 完整例子
 

teacher@H_403_8@>@H_403_8@
        {{name}}
        <student-a@H_403_8@>@H_403_8@</student-a@H_403_8@>@H_403_8@
        <student-b@H_403_8@>@H_403_8@</student-b@H_403_8@>@H_403_8@
    </div@H_403_8@>@H_403_8@
    <//studentA——require指向父级指令teacher@H_403_8@ app.directive('studentA'@H_403_8@,0)">return@H_403_8@ { require@H_403_8@: '?^teacher'@H_403_8@,template: '<div>A`s teacher name: <span>{{teacherName}}</span></div>'@H_403_8@,0)">function@H_403_8@ ($scope,$element,$attrs,ctrl)@H_403_8@ @H_403_8@{ //获取teacher指令控制器，并调用其方法sayName()@H_403_8@ $scope.teacherName = ctrl.sayName(); } }; }); //studentB——require指向父级指令teacher，及指令studentA@H_403_8@ //但是，由于不能获得兄弟，也没有采取？策略，导致报错@H_403_8@ app.directive('studentB'@H_403_8@,210)">require@H_403_8@: ['studentA'@H_403_8@],152)">'<div>B`s teacher name: <span>{{teacherName}}</span></div>'@H_403_8@,ctrl)@H_403_8@ @H_403_8@{ $scope.teacherName = ctrl.sayName(); } }; }); app.directive('teacher'@H_403_8@,152)">'A'@H_403_8@,152)">"Miss wang"@H_403_8@; //扩展控制器的方法sayName，目的是让外部内获取控制器内部数据@H_403_8@ this@H_403_8@.sayName = return@H_403_8@ $scope.name; }; } }; }); @H_403_8@</body@H_403_8@>@H_403_8@
 

 既然require可以获取外部指令，那Angular原生指令应该也是能够获取。其中最广泛应用的就是require: 'ngModel'，关于ngModel在自定义指令上的应用，留待下回实例中再跟大家深入讨论。
 

 行为参数——link与controller
 

 为什么要把link与controller两个参数放到一起？
 因为很多童鞋会把它们错误地混淆使用，包括我自己。
 

 link与controller都是描述指令行为的参数，但它们是要描述的行为是完全不同的类型。
 

 
 
controller语法controller：String or Function
 

 

 controller本身的意义就是赋予指令控制器，而控制器就是定义其内部作用域的行为的。
 

 所以controller要描述的是：指令的作用域的行为@H_403_8@。
 

//指向匿名控制器@H_403_8@
controller: $scope@H_403_8@)@H_403_8@ @H_403_8@{
},//指向控制器mainCtrl@H_403_8@
controller: "mainCtrl"@H_403_8@
 

 
 
link语法link：String Or Function
 

 

 link名称是链接函数，啥意思，好像挺难理解。所以在解释链接函数之前，先要说一下Angular的初始化对于指令究竟做了什么。
 

 Angular在刚从HTTP Response接收静态素材之初，会首先去分析母页HTML中有哪些原生指令或自定义指令，然后再去加载指令的template模板HTML，而template模板中又去加载自己的指令模板，如此类推，直到Angular找到了所有的指令及模板，形成模板树，并返回模板函数，提供给下一阶段进行数据绑定。
 

stu1@H_403_8@ >@H_403_8@</ stu1@H_403_8@>@H_403_8@
    <script@H_403_8@ >@H_403_8@ 'stu1'@H_403_8@,152)">"<p>1</p><stu2></stu2>"@H_403_8@,0)">function@H_403_8@ (scope)@H_403_8@ @H_403_8@{ console@H_403_8@.log( 'stu1 running'@H_403_8@ ); } }; }); app.directive( 'stu2'@H_403_8@,152)">"<p>2</p><stu3></stu3>"@H_403_8@,152)">'stu2 running'@H_403_8@ ); } }; }); app.directive( 'stu3'@H_403_8@,152)">"<p>3</p>"@H_403_8@,152)">'stu3 running'@H_403_8@ ); } }; }); </script@H_403_8@ >@H_403_8@ </ body@H_403_8@>@H_403_8@ console output stu3 running stu2 running stu1 running @H_403_8@@H_403_8@
 

 注意以上例子，在第一个断点stu3 running的时候，1 2 3 三个模板都渲染完成了。然后从最根部的stu3的link函数开始，依次执行stu 3 stu2 stu1的link函数。
 

 简单来说就是：
 

     
 
  1.  
    加载模板，形成DOM模板树
     
    2.  
 
  2.  
    @@@@
     
    3.  
 
  3.  
    数据绑定
     
    4.  

 

 @@@@是啥？没错，就是link链接函数，它会在形成模板树之后，在数据绑定之前，从最底部指令开始，逐个指令执行它们的link函数。
 

 在这个时间节点的link函数，操作DOM的性能开销是最低@H_403_8@，非常适合在这个时机执行DOM的操作，例如鼠标操作或触控事件分发绑定、样式Class设置、增删改元素等等。
 

 所以link就是描述指令元素操作行为。@H_403_8@
 

link@H_403_8@: function (scope,attr,ctrl) {@H_403_8@

 element.bind("click"@H_403_8@,0)">function@H_403_8@ ()@H_403_8@ @H_403_8@{ "绑定点击事件"@H_403_8@); }); element.append("<p>增加段落块</p>"@H_403_8@); //设置样式@H_403_8@ element.css("background-color"@H_403_8@,152)">"yellow"@H_403_8@); //不推荐，在link中赋予scope行为@H_403_8@ scope.hello = "hello"@H_403_8@); }; } @H_403_8@
 

 同理，在link中定义$scope行为是不推荐的。
 

 这样想想，对于controller与link，就明白了。但还有一个问题，它们俩的执行顺序是？答案是先controller，后link@H_403_8@。
 

 放到全局顺序就是：
 

     
 
  1.  
    执行controller，设置各个作用域scope
     
    2.  
 
  2.  
    加载模板，形成DOM模板树
     
    3.  
 
  3.  
    执行link，设置DOM各个行为
     
    4.  
 
  4.  
    数据绑定，最后scope绑上DOM
     
    5.  

 

 例子
 

student@H_403_8@>@H_403_8@
        {{name }}
    </'student'@H_403_8@,152)">"tgor"@H_403_8@; 'controller running'@H_403_8@); },0)">function@H_403_8@ (scope,el)@H_403_8@ @H_403_8@{ el.append("<p>hello</p>"@H_403_8@); 'link running'@H_403_8@); } }; }); @H_403_8@</ 
 

 总结

猜你在找的Angularjs相关文章

AngularJS 简介
AngularJS 是一个JavaScript 框架。它可通过 注：建议把脚本放在 元素的底部。这会提高网页...
angluarjs中页面初始化的时候会出现语法{{}}在页面中问题
angluarjs中页面初始化的时候会出现语法{{}}在页面中问题，也即是页面闪烁问题。出现这个的...
AngularJS 指令
AngularJS 通过被称为指令的新属性来扩展 HTML。AngularJS 指令AngularJS 指令是扩展的 HT...
AngularJS 表达式
AngularJS 使用表达式把数据绑定到 HTML。AngularJS 表达式AngularJS 表达式写在双大括号内...
AngularJS 表格
ng-repeat 指令可以完美的显示表格。在表格中显示数据 {{ x.Name }} {{ x.Country }} 使用...
AngularJS 控制器
AngularJS 控制器控制AngularJS 应用程序的数据。AngularJS 控制器是常规的JavaScript 对象...
AngularJS Filters
过滤器可以使用一个管道字符（|）添加到表达式和指令中。AngularJS 过滤器AngularJS 过滤器...
KeyPress 和KeyDown 、KeUp之间的区别
keyup适用于文本框的数据输入和同步，以及数据的获取；keydown 与 keypress更适用于通过键...
angularjs -- 页面模板清除
angularJs模板缓存的清除，包括传统的 HTML标签设置清除缓存，以及angularJs的一些配置清除...
angularjs -- 监听angularJs列表数据是否渲染完毕
前端在做数据渲染的时候经常会遇到在数据渲染完毕后执行某些操作，这几天就一直遇到在列表...
HTMLHTML5JavaScriptCSSjQueryBootstrapAngularjsTypeScriptVueDojoJsonElectronNode.jsextjsExpress XMLES6AjaxFlashUnityReactFlexAnt DesignWeb前端微信小程序微信公众号
关闭广告单独headers封装代码提示错误整数正则非0开头跳页出页码antd table提示URL未注册公众号支付vue hash模式iSlider车牌键盘循环图片echarts 双折左右布局DllPlugin对象创建打字游戏圈选两栏云函数蒙版ES2020橱窗无缝滚动轮播色块碰撞组件销毁文档操作