剖析Angular Component的源码示例
web component
在介绍angular component之前,我们先简单了解下w3c web components
定义
w3c为统一组件化标准方式,提出web component的标准。
每个组件包含自己的html、css、js代码。
web component标准包括以下四个重要的概念:
1.custom elements(自定义标签):可以创建自定义 html 标记和元素;
2.html templates(html模版):使用 <template> 标签去预定义一些内容,但并不加载至页面,而是使用 js 代码去初始化它;
3.shadow dom(虚拟dom):可以创建完全独立与其他元素的dom子树;
4.html imports(html导入):一种在 html 文档中引入其他 html 文档的方法,<link rel="import" href="example.html" rel="external nofollow" />。
概括来说就是,可以创建自定义标签来引入组件是前端组件化的基础,在页面引用 html 文件和 html 模板是用于支撑编写组件视图和组件资源管理,而 shadow dom 则是隔离组件间代码的冲突和影响。
示例
定义hello-component
<template id="hello-template"> <style> h1 { color: red; } </style> <h1>hello web component!</h1> </template> <script> // 指向导入文档,即本例的index.html var indexdoc = document; // 指向被导入文档,即当前文档hello.html var hellodoc = (indexdoc._currentscript || indexdoc.currentscript).ownerdocument; // 获得上面的模板 var tmpl = hellodoc.queryselector('#hello-template'); // 创建一个新元素的原型,继承自htmlelement var helloproto = object.create(htmlelement.prototype); // 设置 shadow dom 并将模板的内容克隆进去 helloproto.createdcallback = function() { var root = this.createshadowroot(); root.appendchild(indexdoc.importnode(tmpl.content, true)); }; // 注册新元素 var hello = indexdoc.registerelement('hello-component', { prototype: helloproto }); </script>
使用hello-component
<!doctype html> <html lang="zh-cn"> <head> <meta charset="utf-8"> <meta http-equiv="x-ua-compatible" content="ie=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta name="author" content="赖祥燃, laixiangran@163.com, http://www.laixiangran.cn"/> <title>web component</title> <!--导入自定义组件--> <link rel="import" href="hello.html" rel="external nofollow" > </head> <body> <!--自定义标签--> <hello-component></hello-component> </body> </html>
从以上代码可看到,hello.html 为按标准定义的组件(名称为 hello-component ),在这个组件中有自己的结构、样式及逻辑,然后在 index.html 中引入该组件文件,即可像普通标签一样使用。
angular component
angular component属于指令的一种,可以理解为拥有模板的指令。其它两种是属性型指令和结构型指令。
基本组成
@component({ selector: 'demo-component', template: 'demo component' }) export class democomponent {}
- 组件装饰器:每个组件类必须用@component进行装饰才能成为angular组件。
- 组件元数据:组件元数据:selector、template等,下文将着重讲解每个元数据的含义。
- 组件类:组件实际上也是一个普通的类,组件的逻辑都在组件类里定义并实现。
- 组件模板:每个组件都会关联一个模板,这个模板最终会渲染到页面上,页面上这个dom元素就是此组件实例的宿主元素。
组件元数据
自身元数据属性
名称 | 类型 | 作用 |
---|---|---|
animations | animationentrymetadata[] | 设置组件的动画 |
changedetection | changedetectionstrategy | 设置组件的变化监测策略 |
encapsulation | viewencapsulation | 设置组件的视图包装选项 |
entrycomponents | any[] | 设置将被动态插入到该组件视图中的组件列表 |
interpolation | [string, string] | 自定义组件的插值标记,默认是双大括号 |
moduleid | string | 设置该组件在 es/commonjs 规范下的模块id,它被用于解析模板样式的相对路径 |
styleurls | string[] | 设置组件引用的外部样式文件 |
styles | string[] | 设置组件使用的内联样式 |
template | string | 设置组件的内联模板 |
templateurl | string | 设置组件模板所在路径 |
viewproviders | provider[] | 设置组件及其所有子组件(不含contentchildren)可用的服务 |
从 core/directive 继承
名称 | 类型 | 作用 |
---|---|---|
exportas | string | 设置组件实例在模板中的别名,使得可以在模板中调用 |
host | {[key: string]: string} | 设置组件的事件、动作和属性等 |
inputs | string[] | 设置组件的输入属性 |
outputs | string[] | 设置组件的输出属性 |
providers | provider[] | 设置组件及其所有子组件(含contentchildren)可用的服务(依赖注入) |
queries | {[key: string]: any} | 设置需要被注入到组件的查询 |
selector | string | 设置用于在模板中识别该组件的css选择器(组件的自定义标签) |
几种元数据详解
以下几种元数据的等价写法会比元数据设置更简洁易懂,所以一般推荐的是等价写法。
inputs
@component({ selector: 'demo-component', inputs: ['param'] }) export class democomponent { param: any; }
等价于:
@component({ selector: 'demo-component' }) export class democomponent { @input() param: any; }
outputs
@component({ selector: 'demo-component', outputs: ['ready'] }) export class democomponent { ready = new eventemitter<false>(); }
等价于:
@component({ selector: 'demo-component' }) export class democomponent { @output() ready = new eventemitter<false>(); }
host
@component({ selector: 'demo-component', host: { '(click)': 'onclick($event.target)', // 事件 'role': 'nav', // 属性 '[class.pressed]': 'ispressed', // 类 } }) export class democomponent { ispressed: boolean = true; onclick(elem: htmlelement) { console.log(elem); } }
等价于:
@component({ selector: 'demo-component' }) export class democomponent { @hostbinding('attr.role') role = 'nav'; @hostbinding('class.pressed') ispressed: boolean = true; @hostlistener('click', ['$event.target']) onclick(elem: htmlelement) { console.log(elem); } }
queries - 视图查询
@component({ selector: 'demo-component', template: ` <input #theinput type='text' /> <div>demo component</div> `, queries: { theinput: new viewchild('theinput') } }) export class democomponent { theinput: elementref; }
等价于:
@component({ selector: 'demo-component', template: ` <input #theinput type='text' /> <div>demo component</div> ` }) export class democomponent { @viewchild('theinput') theinput: elementref; }
queries - 内容查询
<my-list> <li *ngfor="let item of items;">{{item}}</li> </my-list>
@directive({ selector: 'li' }) export class listitem {}
@component({ selector: 'my-list', template: ` <ul> <ng-content></ng-content> </ul> `, queries: { items: new contentchild(listitem) } }) export class mylistcomponent { items: querylist<listitem>; }
等价于:
@component({ selector: 'my-list', template: ` <ul> <ng-content></ng-content> </ul> ` }) export class mylistcomponent { @contentchild(listitem) items: querylist<listitem>; }
styleurls、styles
styleurls和styles允许同时指定。
优先级:模板内联样式 > styleurls > styles。
建议:使用styleurls引用外部样式表文件,这样代码结构相比styles更清晰、更易于管理。同理,模板推荐使用templateurl引用模板文件。
changedetection
changedetectionstrategy.default:组件的每次变化监测都会检查其内部的所有数据(引用对象也会深度遍历),以此得到前后的数据变化。
changedetectionstrategy.onpush:组件的变化监测只检查输入属性(即@input修饰的变量)的值是否发生变化,当这个值为引用类型(object,array等)时,则只对比该值的引用。
显然,onpush策略相比default降低了变化监测的复杂度,很好地提升了变化监测的性能。如果组件的更新只依赖输入属性的值,那么在该组件上使用onpush策略是一个很好的选择。
encapsulation
viewencapsulation.none:无 shadow dom,并且也无样式包装。
viewencapsulation.emulated:无 shadow dom,但是通过angular提供的样式包装机制来模拟组件的独立性,使得组件的样式不受外部影响,这是angular的默认设置。
viewencapsulation.native:使用原生的 shadow dom 特性。
生命周期
当angular使用构造函数新建组件后,就会按下面的顺序在特定时刻调用这些生命周期钩子方法:
生命周期钩子 | 调用时机 |
---|---|
ngonchanges | 在ngoninit之前调用,或者当组件输入数据(通过@input装饰器显式指定的那些变量)变化时调用。 |
ngoninit | 第一次ngonchanges之后调用。建议此时获取数据,不要在构造函数中获取。 |
ngdocheck | 每次变化监测发生时被调用。 |
ngaftercontentinit | 使用 |
ngaftercontentchecked | ngaftercontentinit后被调用,或者每次变化监测发生时被调用(只适用组件)。 |
ngafterviewinit | 创建了组件的视图及其子视图之后被调用(只适用组件)。 |
ngafterviewchecked | ngafterviewinit,或者每次子组件变化监测时被调用(只适用组件)。 |
ngondestroy | 销毁指令/组件之前触发。此时应将不会被垃圾回收器自动回收的资源(比如已订阅的观察者事件、绑定过的dom事件、通过settimeout或setinterval设置过的计时器等等)手动销毁掉。 |
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
推荐阅读
-
剖析Angular Component的源码示例
-
Angular 组件之间的交互的示例代码
-
Spring源码剖析2:Spring IOC容器的加载过程
-
jQuery插件FusionCharts绘制的2D双柱状图效果示例【附demo源码】
-
jQuery实现的响应鼠标移动方向插件用法示例【附源码下载】
-
angular5 httpclient的示例实战
-
angular4中引入echarts的方法示例
-
Angular外部使用js调用Angular控制器中的函数方法或变量用法示例
-
angular项目中bootstrap-datetimepicker时间插件的使用示例
-
jQuery插件HighCharts绘制2D带Label的折线图效果示例【附demo源码下载】