欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

剖析Angular Component的源码示例

程序员文章站 2023-11-09 21:59:52
web component 在介绍angular component之前,我们先简单了解下w3c web components 定义 w3c为统一组件化标准方式,...

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 {}
  1. 组件装饰器:每个组件类必须用@component进行装饰才能成为angular组件。
  2. 组件元数据:组件元数据:selector、template等,下文将着重讲解每个元数据的含义。
  3. 组件类:组件实际上也是一个普通的类,组件的逻辑都在组件类里定义并实现。
  4. 组件模板:每个组件都会关联一个模板,这个模板最终会渲染到页面上,页面上这个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设置过的计时器等等)手动销毁掉。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。