Angularjs 1 深度解析：组件化编程

转自本身在开源中国的博客：https://my.oschina.net/u/7247...

angular 1 也要面向组件编程

前端组件化是前端开发模式中一个不可逆转的趋势，三大主要前端框架 angular 2 react vue 都不约而同的把组件化编程做为本身的一大卖点，angular 1 做为一个历史相对悠久的框架，在私生子 angular 2 的推进下，终于也搭上了组件化编程的末班车，公司里那些老项目终于也有机会体验组件化编程的滋味。

angular 1 的组件化之路

angular 1 中相似组件化的编程思想其实很早就有，只不过那时候不叫组件，而叫指令（Directive），指定 restrict: 'E' 后这个指令就与现在组件的用法很类似了。angular 1.5 中，又将指令根据 angular 2 的相似概念加以限制，脱胎为现在的组件（Components）。

组件的特色

官方文档列举了组件和指令的不一样点。除此以外，一个规范的组件还应符合如下几个特色。

1. 组件的标签名称必须包含中划线
2. 组件拥有良好的生命周期
3. 组件有自包含性
4. 组件有自封闭性
5. 组件有可复用性
6. 组件能够被定制化

下面依次说明。

组件的名称规范

与指令不一样，组件必须是一个元素，HTML 对于这一点有特殊的规范。

HTML 规范把带有中划线的标签留给开发者使用，这样造成的元素又称做自定义元素（Custom Element）。咱们虽然没有用到自定义元素的概念，但二者的行为是类似的。咱们应该符合这一标准。

这一点规范对应到 angular 1 中即为：组件名称必须带有驼峰形式。

例如：

module.component('dialog', {
    // ...
});

这是不对的。HTML 规范已经定义了 dialog 这个标准元素，重复使用标签名可能致使咱们自定义的组件行为和标准元素的行为混杂到一块儿，致使奇葩 bug；并且若是这样作也间接致使开发者不能使用原生的 dialog 标签。

另外，就算如今标准没有定义某个元素，不表明未来不会定义。咱们的程序既然跑在浏览器里，就要按规矩办事。这是一种合法的写法：

module.component('customDialog', {
    // ...
});

组件的自包含性

一个设计良好的组件必定有它本身的行为和默认样式。

默认行为

默认行为在 angular 1 中用控制器（Controller）定义。

function CustomDialogController($service) {
    this.someField = 123;
    this.someMethod = function someMethod() {

    }
}
CustomDialogController.$inject = ['$service'];

module.component('customDialog', {
    controller: CustomDialogController,
    template: require('./customDialogTemplate.html'),
});

由于组件默认启用 controllerAs，全部变量和函数都是绑定到 this 上的，因此你也可使用 ES2015 的 class 语法来组织代码：

class CustomDialogController {
    constructor($service) {

    }

    someMethod() {

    }
}
CustomDialogController.$inject = ['$service'];

module.component('customDialog', {
    controller: CustomDialogController,
    template: require('./customDialogTemplate.html'),
});

这样作有一个问题就是其余函数不能使用 constructor 里注入的服务（Service），只能经过 this 中转一次。我我的的作法是这样：

class CustomDialogController {
    constructor($service) {
        this.services = { $service };
    }

    someMethod() {
        const { $service } = this.services;
    }
}
// 下略

建议对于逻辑相对简单的组件的控制器使用 function 定义，复杂的组件使用 class 定义，后者代码的层次要更为清晰易读。

默认样式

组件的默认样式直接使用样式表指定。

custom-dialog {
    display: block;
    // ...
}

对于全部浏览器不认识的标签，默认都是内联元素（display: inline），对于组件来讲一般不是想要的。因此自定义的组件一般至少要有 display: (inline-)block 来改变元素的默认显示方式。

组件的自封闭性

自封闭性包含两个方面：数据的自封闭性和样式的自封闭性。

数据的自封闭性

angular 1 中，组件自身的 scope 已是隔离的（isolate），即组件的 scope 不继承自父级 scope（__proto__ 为 null）。除此以外，一个规范的组件不该该直接使用外部的数据，由于这样会破坏组件的可复用性。举几个例子：

1. $rootScope
2. $root、$parent（模板中）
3. 路由参数
4. localStorage、sessionStorage

这些数据都应该经过参数绑定 binding 传入。若是组件是路由插件生成，那么能够用 resolve。

其次，参数绑定不该使用双向绑定 =，规范的组件不该（直接）修改组件外部传入的数据。官方推荐的参数绑定方式有两种

1. < 单向绑定，绑定可变数据。一般用于给组件传递数据
2. @ 字符串绑定，绑定字符串。一般用于指定组件行为

对于单向绑定对象的状况，因为是引用传递，也不该该修改对象内部的属性。

遇到要向外部传值的状况，推荐使用 ngModel 或 事件绑定（下面会提到）

样式的自封闭性

组件间的样式不该该互相干扰，这一点能够简单的经过 scss 的样式嵌套（Nesting）实现：

custom-dialog {
    display: block;
    // ...

    .title {
        // ...
    }

    .body {
        // ...
    }
}

这样能够简单的把组件的内置样式表限制在组件内部，从而避免样式外溢。可是这种方法对在组件内部的其余组件不起效果。若是这个组件的模板中还引用了别的组件，或者这个组件被定义为可嵌入的（transclude），那么能够考虑加类名前缀：

custom-dialog {
    display: block;

    .custom-dialog {
        &-title {
            // ..
        }

        &-body {

        }
    }
}

组件的可复用性

组件为复用而生，拥有良好自封闭性的组件必然是可复用的，由于这个组件不受任何外部因素干扰。组件的复用形式包括

1. 一个页面中使用屡次
2. 在多个页面中使用
3. ng-repeat
4. 本身套本身（递归树结构）
5. 整个源代码拷贝到其余项目中

等等。一个高度可复用的组件则能够被称为控件，是能够单独投稿 npm 项目库的。

固然，有些组件（好比单独的页面）可能复用需求没那么高，能够视组件的复用程度不一样，从组件的自封闭性和总体代码量作一些取舍。

组件的定制化

一个高度可复用的组件必定能够被定制。

行为的定制化

经过参数绑定实现组件行为的定制化。例如：

<custom-dialog x-title="My Dialog" x-modal="true"><!-- 与标签名同样，自定义属性名也应该使用中划线 -->
    <!--content -->
</custom-dialog>

module.component('customDialog', {
    template: require('./customDialogTemplate.html'),
    transclude: true,
    bindings: {
        title: "@",
        modal: '<',
    },
});

出于使用方便的考虑，定制用的参数都是可选的，组件内部实现应该给每一个定制参数设定默认值。

样式的定制化

组件风格定制可使用 class 判断。

custom-dialog {
    display: block;
    // ...

    .title {
        font-size: 16px;
        // ...
    }

    &.big {
        .title {
            font-size: 24px;
        }
    }
}

使用时

<custom-dialog x-title="My Dialog" class="mydialog big"></custom-dialog>

深度定制样式比较好的方式是 CSS 属性（CSS Variable，注意不是 SCSS 属性）。

custom-dialog {
    display: block;
    // ...

    .title {
        font-size: 16px;
        color: var(--dialog-title-color, #333);
        // ...
    }

    &.big {
        .title {
            font-size: 24px;
        }
    }
}

这时只须要文档中说明标题颜色使用 --dialog-title-color 这个 CSS 变量就好，外部使用不依赖于组件内部 DOM 实现。使用时

.mydialog {
    --dialog-title-color: red;
}

组件的生命周期

从建立至销毁，组件有本身的生命周期（lifecycle），而不像指令那样把 scope 做为生命周期。经常使用的回调函数以下：

• $onInit()：组件被初始化时调用。与 constructor 不一样，angular 1 确保 $onInit 被调用时组件的全部参数绑定都被正确赋值。
• $onChanges(changeObj)：组件参数绑定值被改变时调用。用于监听绑定值的变化，初次绑定时也会调用这个函数。
• $onDestroy()：组件被销毁时调用。用于清理内部资源如 $interval 等。

这些函数也是绑定在 this 上的。若是 controller 使用 ES2015 的 class 定义方式，能够这么写：

class CustomDialogController {
    constructor() {}

    onInit() {}

    onChanges({ prop1, prop2 }) {}

    onDestroy() {}
}

组件间的通讯

组件间通讯是一个让不少人头疼的问题，一般有这样 3 种状况

子 -> 父

这种状况有标准的实现方式：事件绑定。例如

class CustomDialogController {
    close($value) {
        this.hide = true;
        this.onClose({ $value });
    }
}

module.component('customDialog', {
    controller: CustomDialogController,
    template: require('./customDialogTemplate.html'),
    bindings: {
        onClose: '&',
    },
});

使用时：

<custom-dialog on-close="$ctrl.handleClose(value)"></custom-dialog>

这种方式也能够用于子组件向父组件传值。

父 -> 子

用于触发子组件的某个动做。除了改变某个在子组件内部监听变化的绑定参数值外，行之有效的方式就只有事件广播。

子组件先监听某个事件

$scope.$on('custom-dialog--close', () => this.close());

父组件发送广播

$scope.$broadcast('custom-dialog--close');

切记：事件是全局性的。当有组件复用的状况时请使用标识指定接收对象（BUS 模型）；另外最好给事件名添加组件前缀。

同级组件

请经过父级组件中转

子 -> 某全局性组件

这个显示 Notification 时最经常使用。遇到这种状况时，能够封装服务（Service）。例如：

module.component('globalNotification', {
    controller: class GlobalNotificationController {
        constructor(notificationService) {
            notificationService.component = this;
        }

        show(props) {
            // ...
        }
    }
});

module.factory('notify', function NotifyService() {
    return {
        warn(msg) {
            this.show({ type: 'warn', text: msg });
        }
        error(msg) {
            this.show({ type: 'error', text: msg });
        }
    }
});

方案并不完美。若是有更好的建议欢迎提出。

结语

有人可能问既然三大前端框架都是组件化的，何须还要在 angular 1 上实现。却不知 angular 1 的组件诞生的初衷就是为了减小向 angular 2 迁移的难度。机会老是留给有准备的人，哪天老板大发慈悲表示给你把代码重写的时间，你却看着项目里满屏的 $scope.abc = xxx 不知所措，这岂不是悲剧。。。

完