angular6.x系列的学习笔记记录,仍在不断完善中,学习地址:
(3)内容投影, ViewChild和ContentChild
大家应该都知道,在html中存在一些附加在元素节点上的标记,例如属性,事件等等.它们能够改变元素的行为,甚至操作DOM,改变DOM元素,以及它的各级子节点.
那么,在angular中也有这样的存在,那就是指令.
在 Angular 中有三种类型的指令：
在查看源代码,我们会发现这样的画面
所以说组件是继承指令的,只是它比较特殊,有模版
同样,因为组件继承指令,在下面属性型和结构型指令的一系列操作,在组件中都是可以实现的
但是因为指令的目的是为了复用,在组件中这样操作是达不到这个目的,所以强烈不推荐这样去操作.
这里就不多做说明,有兴趣可以自己尝试一下
上面说道属性型指令是用来改变元素、组件或其它指令的外观和行为
那么我们如何打造属于自己的属性型指令呢?
首先,创建指令很像创建组件。
对于指令而言,至少需要一个带有@Directive装饰器的控制器类。该装饰器指定了一个用于标识属性的选择器。 控制器类实现了指令需要的指令行为。
在我们存放指令的文件夹下(例如src/app/directives)下执行下面cli命令
ng generate directive name(简写ng g d name)
就可以快速得到src/app/directives/name.directive.ts和相应的测试文件src/app/directives/name.directive.spec.ts
并且在根模块AppModule中声明这个指令类。
根据命令快速创建一个名为highlight的指令。基本代码如下:
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppRoutingModule } from './app-routing.module';
import { AppComponent } from './app.component';
import { HighlightDirective } from './directive/highlight.directive';
@NgModule({
declarations: [
AppComponent,
HighlightDirective,
],
imports: [
BrowserModule,
AppRoutingModule
],
providers: [],
bootstrap: [AppComponent]
})
export class AppModule { }
import { Directive } from '@angular/core';
@Directive({
selector: '[appHighlight]'
})
export class HighlightDirective {
constructor() { }
}
Warnning
和组件一样，这些指令也必须在Angular模块中进行声明
指令所在的元素就是它的宿主元素
下面以一个实例展示如何自定义属性型指令:highlight的功能如下
具体代码如下
src/app/directives/highlight.directive.ts
import { Directive, ElementRef, HostListener, Input } from '@angular/core';
@Directive({
//指定指令的属性型选择器
selector: '[appHighlight]'
})
export class HighlightDirective {
@Input('appHighlight') highlightColor: string;
@Input() defaultColor: string;
//构造函数中使用 ElementRef 来注入宿主 DOM 元素的引用
constructor(private el: ElementRef) { }
//监听宿主元素mousenter事件
@HostListener('mouseenter') onMouseEnter() {
this.highlight(this.highlightColor || this.defaultColor);
}
//监听宿主元素mousenter事件
@HostListener('mouseleave') onMouseLeave() {
this.highlight(null);
}
private highlight(color: string) {
//ElementRef通过其 nativeElement 属性,提供直接访问宿主 DOM 元素的能力。
this.el.nativeElement.style.backgroundColor = color;
}
}
宿主元素用法
<p appHighlight="red" defaultColor="black">宿主元素</p>
最终效果
结构性基本知识和上面的属性型指令差不多,但是它必须导入 Input、TemplateRef 和 ViewContainerRef，因为我们必须得有值来确定的是什么样的结构.
在说道结构性指令的时候,例如*ngIf,ngFor(ngSwitch其实也有,不过是在内部),都会看到前面有一个号,它是用来干嘛的呢?
其实这里星号是一个用来简化更复杂语法的“语法糖”,从内部实现来说:以*ngIf为例,Angular 把 *ngIf 属性翻译成一个 元素 并用它来包裹宿主元素
<ng-template [ngIf]="bool">
<div class="name">{{hero.name}}</div>
</ng-template>
指令
是一个 Angular 元素，用来渲染 HTML。 它永远不会直接显示出来。 事实上，在渲染视图之前，Angular 会把 及其内容替换为一个注释。如果没有使用结构型指令，而仅仅把一些别的元素包装进 中，那些元素就是不可见的。
在下面的这个短语"Hip! Hip! Hooray!"中，中间的这个 "Hip!"不会显示就是如此。
<p>Hip!</p>
<ng-template>
<p>Hip!</p>
</ng-template>
<p>Hooray!</p>
但是结构型指令会让 正常工作，在下面自定义结构型指令时就会看到这一点.
指令
Angular 的 是一个分组元素，但它不会污染样式或元素布局，因为 Angular 压根不会把它放进 DOM 中。
下面是重新实现的条件化段落，这次使用 ,都可以显示
<p>
I turned the corner
<ng-container *ngIf="bool">
and saw {{hero.name}}. I waved
</ng-container>
and continued on my way.
</p>
TemplateRef 和 ViewContainerRef
像上面简单结构型指令例子,会从 Angular 生成的 元素中创建一个内嵌的视图，并把这个视图插入到一个视图容器中.可以使用TemplateRef取得 的内容，并通过ViewContainerRef来访问这个视图容器。可以把它们都注入到指令的构造函数中，作为该类的私有属性,详见下面自定义结构型指令
我们来自定义一个名为appUnless的结构型指令,该指令的使用者会把一个 true/false 条件绑定到 [appUnless] 属性上。实现与*ngIf相反的功能
具体代码如下
import { Directive, TemplateRef, Input, ViewContainerRef } from '@angular/core';
@Directive({
selector: '[appUnless]'
})
export class UnlessDirective {
private hasView: boolean = false;
@Input() set appUnless(condition: boolean) {
if (!condition && !this.hasView) {
this.viewContainer.createEmbeddedView(this.templateref);
this.hasView = true;
}
else if (condition && this.hasView) {
this.viewContainer.clear();
this.hasView = false;
}
}
constructor(
private templateref: TemplateRef<any>,
private viewContainer: ViewContainerRef
) { }
}
<!-- ts里定义 condition: boolean = false;-->
<p *appUnless="condition" class="unless a">
(A) This paragraph is displayed because the condition is false.
</p>
<p *appUnless="!condition" class="unless b">
(B) Although the condition is true,
this paragraph is displayed because appUnless is set to false.
</p>
效果如下
对于简单的段落，隐藏和移除之间的差异影响不大，但对于资源占用较多的组件是不一样的。 当隐藏掉一个元素时，组件的行为还在继续 —— 它仍然附加在它所属的 DOM 元素上， 它也仍在监听事件。Angular 会继续检查哪些能影响数据绑定的变更。 组件原本要做的那些事情仍在继续。所在在使用结构型指令操作时,我们需要明白这一点
Warnning
每个宿主元素上只能有一个结构型指令,你可能试过把 *ngFor 和 *ngIf 放在同一个宿主元素上，但 Angular不允许。这是因为你在一个元素上只能放一个结构型指令。
angular自带的有许多内置的指令,下面可以看见许多熟悉的身影:
详情参见官网传送门,大家有兴趣就多去看看
(终)