自定义指令实现手风琴菜单 AngularJS

0x00 前言

自定义指令在angular中是比较难的一个点,写了这么长时间也只会一些简单的单指令,翻出《用AngularJS开发下一代Web应用》,拿出里面的accordion例子好好啃一下。

这个例子整体比较简单,但是还是需要了解一些点:

  1. 自定义指令语法

  2. 指令独立作用域:这里双向绑定用=

  3. 指令transclude

  4. 指令controller:require的controller作为link函数的第四个参数

  5. 指令link函数:每个指令都执行一次,而compile只编译一次

0x01 效果

自定义指令实现手风琴菜单  AngularJS

很简单的点击一个当前展开,其他折叠
其中expander是从controller中循环出来的

预览:https://jsfiddle.net/savokiss/fh5sv52u/

0x02 View

<accordion>
      <expander class='expander' ng-repeat='expander in expanders' expander-title='expander.title'>
          {{expander.text}}
      </expander>
  </accordion>

需要两个自定义指令accordion和expander

0x03 Controller

$scope.expanders = [{
    title : 'Click me to expand',
    text : 'Hi there folks, I am the content that was hidden but is now shown.'
  }, {
    title : 'Click this',
    text : 'I am even better text than you have seen previously'
  }, {
    title : 'Test',
    text : 'test'
  }];

只有一个数组,定义了expander的title和text

0x04 Directives

父级指令accordion

myModule.directive('accordion',function(){
  return {
          restrict : 'EA',
          replace : true,
          transclude : true,
          template : '<div ng-transclude></div>',
          controller : function() {
              var expanders = [];
              this.gotOpened = function(selectedExpander) {
                  angular.forEach(expanders, function(expander) {
                      if (selectedExpander != expander) {
                          expander.showMe = false;
                      }
                  });
              };
              this.addExpander = function(expander) {
                  expanders.push(expander);
              };
          }
      };
});

这是手风琴菜单的父级指令,他的作用主要为:

  1. expanders用来存放子指令的数据(即子集scope)

  2. addExpander方法用来在子指令调用link函数时初始化expanders数组

  3. gotOpened方法用来提供给子指令关闭其他expander

子集指令expander

myModule.directive('expander', function(){
  return {
          restrict : 'EA',
          replace : true,
          transclude : true,
          require : '^?accordion',
          scope : {
              expanderTitle : '='
          },
          template : '<div>'
                   + '<div class="ex-title" ng-click="toggle()">{{expanderTitle}}</div>'
                   + '<div class="ex-body" ng-show="showMe" ng-transclude></div>'
                   + '</div>',
          link : function(scope, iElement, iAttrs, accordionController) {
              scope.showMe = false;
              accordionController.addExpander(scope);
              scope.toggle = function toggle() {
                  scope.showMe = !scope.showMe;
                  accordionController.gotOpened(scope);
              };
          }
      };
});

此指令说明:

  1. require了accordion指令,所以link函数的最后一个参数就是accordion的controller

  2. 独立scope中的expanderTitle用来双向绑定controller中的title

  3. transclude用来直接将view中的代码传进来,当然这里只显示了expander的text

  4. link函数提供了flag: scope.showMe,用来控制expander的展开状态

  5. link函数中初始化showMe为false,初始化将当前指令的scope添加到父级指令的expander数组中去

  6. 提供给自己scope.toggle方法,用来在切换开关状态,并调用父级指令关闭其他兄弟

0x05 完

基本上就是这些点,全get到就差不多也能写类似的指令了~

相关推荐