【教程】（Angular）模版引用变量的魔法

【翻译】【教程】模版引用变量的魔法

原文连接： https://blog.angulartraining....
做者： Alain Chautard
译者： 而井

模版引用变量是个好东西，它容许Angular完成许多有用的事情。我常常称这个功能为“井号语法”，由于在模版中它依赖一个简单的井号来建立对一个元素（译者注：元素包括HTML元素和组件元素）的引用：

<input #phone placeholder="phone number">

上述的语法是如此的简洁：它建立了一个指向input元素的引用，这个引用稍后能够在个人模版中使用。须要注意的是，这个（引用）变量的做用域是它所定义的整个HTML模版（的范围）（译者注：即在定义这个引用变量的HTML模版中均可以访问这个变量）。

例如，这里就是我如何用这个引用来获取输入框的值（的例子）：

<!-- phone指向输入框元素 --> 
<button (click)="callPhone(phone.value)">Call</button>

注意那个phone（变量）指向了input的HTMLElement对象实例。因此phone（变量）持有了（相应）HTMLElement（实例对象）的任何属性和方法，如id、name、innerHTML、value等。

上述是一种避免使用ngModel或其余数据绑定的好方法，（由于）这种方法在校验方面上不须要写太多代码。

在组件上也奏效吗？

答案就是能够奏效！假设咱们有HelloWorldComponent以下：

@Component({
  selector: 'app-hello',
  template: `
    <div>
      <h2>Hello {{name}}</h2>
    </div>
  `
})
export class HelloComponent {

   name = 'Angular';
}

如今按照以下代码，咱们使用了“井号语法”获得了组件的引用：

<app-hello #helloComp></app-hello>

它（模版引用变量）一个最好的地方就是咱们能够获取实际上的组件实例对象HelloWorldComponent。因此咱们能够访问这个组件的任何方法或属性，即便他们（的权限）是声明为私有或保护的，多么使人惊喜：

<app-hello #helloComp></app-hello>
<!-- 下面这个表达式将会显示（文本）"Angular" -->
{{helloComp.name}}

咱们不只能够经过这种语法来读取一个组件的数据，并且也能修改它。

对指令也奏效吗？

固然（能够），不过这里须要进一步了解它（模版引用变量）。大部分的指令将会被做为（译者注：HTML或组件标签）的属性来使用，这意味着咱们没法在那里真正应用“井号语法”，除非咱们使用相同的语法进行扭转：

<form (ngSubmit)="onSubmit(myForm)" #myForm="ngForm">

在上面的例子里，myForm是一个指向（应用于表单的）ngForm指令的引用。

如今若是你细看上面的HTML元素，你可能会想：“等一下，那里并无ngForm指令！我没有见过任何属性叫ngForm的！”，你（若是）这样想就对了。

答案就在ngForm指令的源代码中：

@Directive({
  selector: 'form:not([ngNoForm]):not([formGroup]),ngForm,[ngForm]',
  ...
  exportAs: 'ngForm'
})

看到那个指令的选择器的了没？它（指令）将应用于任何没有ngNoForm和formGroup属性的form表单元素之上。所以，ngForm指令将自动应用于个人form元素之上。

第二个被注意到的趣事就是装饰器中的exportAs属性。它告诉Angular：“嘿，若是有人想用模版引用变量来指向这个指令，（那么指令的）名字就叫作ngForm”。

如今咱们已经知道它是如何运做的了。咱们能够建立定制指令，并经过一个叫exportAs的来暴露该指令。

译者附

为了方便你们理解模版引用变量对指令的操控，我把相关连接的核心演示代码附在本文最后面。

import {Component} from '@angular/core';
import {NgForm} from '@angular/forms';
 
@Component({
  selector: 'example-app',
  template: `
    <form #f="ngForm" (ngSubmit)="onSubmit(f)" novalidate>
      <input name="first" ngModel required #first="ngModel">
      <input name="last" ngModel>
      <button>Submit</button>
    </form>
    
    <p>First name value: {{ first.value }}</p>
    <p>First name valid: {{ first.valid }}</p>
    <p>Form value: {{ f.value | json }}</p>
    <p>Form valid: {{ f.valid }}</p>
  `,
})
export class SimpleFormComp {
  onSubmit(f: NgForm) {
    console.log(f.value); // { first: '', last: '' }
    console.log(f.valid); // false
  }
}