构建一个自定义 angular2 输入组件

原文

构建一个自定义 angular2 输入组件

今天我们来学习如何正确的构建和一个具有和 <input type="text"> 同样作用，但同时也具有自己的逻辑的输入组件。

在读这篇文章之前，希望你已经把官方的文档和案例都看过至少一遍了，具体的一些概念和细节不会在文章中讲解。

我们先来看一下我们这篇文章里面所介绍的组件的表现形式是怎么样的：

OK，上图就是我们所要达到的效果了。那么，我们来分析下我们这个组件该具备哪些功能。

  • 聚焦的时候，底部边框为绿色

  • 具有自己的部分逻辑，比如在有输入值的情况下，会出现一个删除图标

  • 当输入值为空的时候，提示错误文案

  • 可以插入其它的 DOM，比如最下面的发送验证码按钮

  • 支持 input 的必要属性，比如 maxlength、placeholder等

  • 支持表单 angular2 form-control 表单绑定，如上图中的值都是从 FormBuilder 中构建的

我们将在后面一步步的来讲解如何实现这样一个自定义组件的功能；

创建一个 angular2 组件

我们先来构建一个基础的 angular2 组件,这里我们先新建一个叫做 input-control 的组件。

首先是 input-control.component.ts 文件：

@Component({
  selector: 'input-control',templateUrl: 'input-control.component.html',styleUrls: ['input-control.component.scss'],encapsulation: ViewEncapsulation.None,})

然后是 input-control.component.html 文件：

<input #input
  [type]="type"
  [name]="name"
  (focus)="_handleFocus($event)"
  (blur)="_handleBlur($event)"
  [placeholder]="placeholder"
  [(ngModel)]="value"
  [minlength]="minlength"
  [maxlength]="maxlength"
  [readonly]="readonly"
  [disabled]="disabled">
<i #iconDelete *ngIf="focused && !readonly" class="icon icon-delete" (click)="_handleClear($event)"></i>

剩下就是 input-control.component.scss 文件了，这里我就不贴出代码了，各位可以根据自己的项目来设置对应的样式

最后，就是我们调用的时候的方式:

<input-control class="input-control"
  [class.error]="!mobile.valid && mobile.touched"
  type="tel"
  name="mobile"
  placeholder="手机号"
  maxlength="11"
  [formControl]="mobile">
  <p *ngIf="mobile.touched && mobile.hasError('mobile')" class="error-tips">请输入正确的手机号码</p>
</input-control>

是否对于上面的一些属性和变量感到困惑，别急，让我一步步道来！

功能细分

输入属性 @input()

有一点要谨记：我们是在用 DIV 来模拟一个 input 的表现，同时具备自己的逻辑; 所以，当我们需要 input 的对应属性值的时候，我们都需要从父容器传递到组件内部的 input 上面，所以在这里我们需要用到 @Input 特性了

我们在 input-control.component.ts 定义我们所需的一些属性：

@Component({
  selector: 'input-control',host: {
    // 宿主元素 click 事件，触发 focus() 事件
    '(click)': 'focus()',// 切换宿主元素 focus 样式
    '[class.focus]': 'focused'
  }
})
export class InputControlComponent {
  private _focused: boolean = false;
  private _value: any = '';
  private _disabled: boolean = false;
  private _readonly: boolean = false;
  private _required: boolean = false;

  // 外部传入属性
  @input() type: string = 'text';
  @input() name: string = null;
  @input() placeholder: string = null;
  @input() minlength: number;
  @input() maxlength: number;

  // value 属性，以 get 方式拦截
  get value(): any {
    return this._value;
  };

  @input() set value(v: any) {
    v = this._convertValueForInputType(v);
    if (v !== this._value) {
      this._value = v;
      // 触发值改变事件，冒泡给父级
      this._onChangeCallback(v);
    }
  }

  // 只读属性
  get focused() {
    return this._focused;
  }

  @input()
  get disabled(): boolean {
    return this._disabled;
  }
  set disabled(value) {
    this._disabled = this._coerceBooleanProperty(value);
  }

  @input()
  get readonly(): boolean {
    return this._readonly;
  }
  set readonly(value) {
    this._readonly = this._coerceBooleanProperty(value);
  }

  @input()
  get required(): boolean {
    return this._required;
  }
  set required(value) {
    this._required = this._coerceBooleanProperty(value);
  }
}

回顾的我们前面的 input-control.component.html 文件，我们定义了 type、name、placeholder、minlength、maxlength 可读写的属性，同时还有 value、readonly、disabled、required 等只读属性。通过 [属性]="源" 方式，接收父级传入的数据。

OK，属性我们都知道如何从父级去接收了，那么接下来我们来实现 点击 操作：

我们先修改 input-control.component.ts 文件

@Component({
  ……
  host: {
    // 宿主元素 click 事件，触发 focus() 事件
    '(click)': 'focus()',// 切换宿主元素 focus 样式
    '[class.focus]': 'focused'
  }
})

我们利用了 host 这个属性，用来给宿主元素对应操作，传送门 @Component 相关属性;
我们给宿主元素也就是 <input-control></input-control> 绑定了一个 click 事件，同时根据自身属性 focused 来切换一个 .focus 类。在我们组件的 focus() 事件中，我们需要让组件内部的 input 聚焦，同时切换自身的 focused 值。为了拿到我们组件内部的 input 元素，这里我们需要使用 @ViewChild()。

修改 input-control.component.ts 文件如下：

@Component({
  ……
  host: {
    // 宿主元素 click 事件，触发 focus() 事件
    '(click)': 'focus()',// 切换宿主元素 focus 样式
    '[class.focus]': 'focused'
  }
})
export class InputControlComponent {
  ……
  ……

  private _focusEmitter: EventEmitter<FocusEvent> = new EventEmitter<FocusEvent>();
  @ViewChild('input') _inputElement: ElementRef; // 组件内部 input 元素
  @ViewChild('iconDelete') iconDelete: ElementRef; // 删除图标元素

  constructor(private hostRef: ElementRef) {
  }

  // 监听全局的点击事件，如果不是当前 input-control 组，则视为失去焦点操作
  @HostListener('window:click',['$event'])
  inputControlBlurHandler(event) {
    var parent = event.target;
    // 如何当前节点不是宿主节点，并且不等于 document 节点
    while (parent && parent != this.hostRef.nativeElement && parent != document) {
      // 取当前节点的父节点继续寻找
      parent = parent.parentNode;
    }

    // 找到最顶层，则表示已经不在宿主元素内部了，触发失去焦点 fn
    if (parent == document) {
      this._focused = false;
    }
  }

  // 宿主聚焦
  focus() {
    // 触发下面的 _handleFocus() 事件
    this._inputElement.nativeElement.focus();
  }

  // 输入框聚焦
  _handleFocus(event: FocusEvent) {
    this._focused = true;
    this._focusEmitter.emit(event);
  }

  // 清空输入值
  _handleClear() {
    this.value = '';
    return false;
  }

  // 这里触发 blur 操作，但是不改变 this._focused 的值，
  // 不然删除图标无法实现它的功能，
  //设置 this._focused 的值将由上面的 @HostListener('window:click',['$event']) 来处理
  // 触发父级的 blur 事件
  _handleBlur(event: any) {
    this._onTouchedCallback();
    this._blurEmitter.emit(event);
  }

  // 对外暴露 focus 事件
  @Output('focus') onFocus = this._focusEmitter.asObservable();
  ……
  ……
}

在上面的代码中，我们通过宿主的 focus() 事件，让 input 元素 focus,同时 input 元素聚焦之后，会触发下面的 _handleFocus() 方法，在这个方法里面，我们修改组件自身的 focused 属性，并对外发射一个 focus 事件，用来向父级传递使用。同时，我们的删除图标也是根据组件的 focused 属性切换显示：

<input #input
  [type]="type"
  [name]="name"
  (focus)="_handleFocus($event)"
  (blur)="_handleBlur($event)"
  [placeholder]="placeholder"
  [(ngModel)]="value">
<i #iconDelete 
    *ngIf="focused && !readonly" 
    class="icon icon-delete" 
    (click)="_handleClear($event)"></i>

我们的 input 和组件内部的 value 属性进行了双向绑定，所以在 _handleClear 之后，我们的输入框的值自然也就被清空了。

值访问器 ControlValueAccessor

在完成上面的一些步骤之后，我们的组件基本功能完成了，但是接下来还有最重要的一部分内容，那就是让我们的自定义组件获得 值访问 权限。
在官方的文档中有提到一点 https://github.com/angular/material2/blob/master/src/lib/input/input.ts


在查看官方的文档之后，我们发现要实现自定义组件的值访问权限，我们需要继承 ControlValueAccessor 接口，同时实现它内部的对应的接口

// 要实现双向数据绑定，这个不可少
export const INPUT_CONTROL_VALUE_ACCESSOR: any = {
  provide: NG_VALUE_ACCESSOR,useExisting: forwardRef(() => InputControlComponent),multi: true
};

const noop = () => {
};

@Component({
  selector: 'input-control',// 切换宿主元素 focus 样式
    '[class.focus]': 'focused'
  },// 
  encapsulation: ViewEncapsulation.None,providers: [INPUT_CONTROL_VALUE_ACCESSOR]
})
export class InputControlComponent implements ControlValueAccessor {
  ……
  ……
  /** Callback registered via registerOnTouched (ControlValueAccessor)
   * 此属性在做表单校验的时候，不可少，
   * 如果缺少了这个属性，FormControl.touched 属性将监测不到，切记！！
   */
  private _onTouchedCallback: () => void = noop;
  /** Callback registered via registerOnChange (ControlValueAccessor) */
  private _onChangeCallback: (_: any) => void = noop;

  /**
   * Write a new value to the element.
   */
  writeValue(value: any) {
    this._value = value;
  }

  /**
   * Set the function to be called when the control receives a change event.
   */
  registerOnChange(fn: any) {
    this._onChangeCallback = fn;
  };

  /**
   * Set the function to be called when the control receives a touch event.
   */
  registerOnTouched(fn: any) {
    this._onTouchedCallback = fn;
  }
  ……
  ……
}

正如上面代码中所示的一样，实现了这些对应的接口之后，我们就能像使用普通的 input 元素一样使用我们的自定义组件了。

允许组件加载内部其它的 DOM 元素

回顾我们前面文章开头的 GIF 图片，我们还有一个获取验证码的按钮，同时，我们的错误提示也是放在组件内部的。要支持这种形式的，我们需要在组件内部加上 <ng-content></ng-content> 标签
有了这个之后，所有包裹在 <input-control></input-control> 组件内部的元素都将被渲染到组件内部

父组件调用 input-control:

<input-control class="input-control sms-control"
  [class.error]="!captcha.valid && captcha.touched"
  type="tel"
  name="captcha"
  placeholder="请输入验证码"
  [formControl]="captcha"
  maxlength="5">
  <count-down class="btn-send-sms" counter="50" title="获取验证码" countText="秒后重新获取"></count-down>
  <p *ngIf="!captcha.valid && captcha.touched" class="error-tips">请输入验证码</p>
</input-control>

浏览器渲染之后的的 DOM 结构：

<input-control class="input-control sms-control ng-untouched ng-pristine ng-invalid" maxlength="5" name="captcha" placeholder="请输入验证码" type="tel" ng-reflect-maxlength="5" ng-reflect-type="tel" ng-reflect-name="captcha" ng-reflect-placeholder="请输入验证码" ng-reflect-form="[object Object]">
  <input ng-reflect-maxlength="5" ng-reflect-name="captcha" ng-reflect-type="tel" type="tel" ng-reflect-placeholder="请输入验证码" placeholder="请输入验证码" maxlength="5" class="ng-untouched ng-pristine ng-valid">
<!--template bindings={
  "ng-reflect-ng-if": null
}-->
  <count-down class="btn-send-sms" counttext="秒后重新获取" counter="50" title="获取验证码" ng-reflect-counter="50" ng-reflect-title="获取验证码" ng-reflect-count-text="秒后重新获取"><button>获取验证码</button></count-down>
      <!--template bindings={
  "ng-reflect-ng-if": null
}-->
</input-control>

与 FormControl 结合使用注意事项

在后期的时候，我整合了自定输入组件与 FormControl 一起使用，在使用过程中，发现在需要使用 .touched 特性的时候，发现无法生效，通过查资料发现，如果需要让这个特性生性，我们的输入组件必须监听 blur 事件并且在处理事件中调用触发对外的 blur 事件，具体代码见前面的 _handleBlur() 内容。


完整 Demo 地址：mcare-app
这个 Demo 里面整合了路由、子模块、服务、动态表单等特性的使用方法，有兴趣的可以参考下，还在持续完善中。这个 Demo 是参照自己做过的项目部分UI，当然不会涉及核心的业务代码：）。

参考资料

Angular2 material2 官方UI库
CUSTOM FORM CONTROLS IN ANGULAR 2
http://stackoverflow.com/questions/38447681/touched-untouched-not-updating-in-custom-input-component-angular-2

构建一个自定义 angular2 输入组件的更多相关文章

  1. HTML5 input新增type属性color颜色拾取器的实例代码

    type 属性规定 input 元素的类型。本文较详细的给大家介绍了HTML5 input新增type属性color颜色拾取器的实例代码，感兴趣的朋友跟随脚本之家小编一起看看吧

  2. 详解通过focusout事件解决IOS键盘收起时界面不归位的问题

    这篇文章主要介绍了详解通过focusout事件解决IOS键盘收起时界面不归位的问题，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧

  3. 移动HTML5前端框架—MUI的使用

    这篇文章主要介绍了移动HTML5前端框架—MUI的使用的相关资料，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧

  4. wordpress添加Html5的表单验证required方法小结

    这篇文章主要介绍了wordpress添加Html5的表单验证required方法小结,本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下

  5. 使用placeholder属性设置input文本框的提示信息

    这篇文章主要介绍了使用placeholder属性设置input文本框的提示信息,本文给大家介绍的非常详细，具有一定的参考借鉴价值，需要的朋友可以参考下

  6. Bootstrap File Input文件上传组件

    这篇文章主要介绍了Bootstrap File Input文件上传组件,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下

  7. HTML5中input输入框默认提示文字向左向右移动的示例代码

    这篇文章主要介绍了HTML5中input输入框默认提示文字向左向右移动，本文通过实例代码给大家介绍的非常详细对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下

  8. 如何在警报视图IOS中创建两个文本字段

    =========工作解决方案===========感谢下面的答案,当你只需要两个纯文本字段时解决方法分配“消息”警报视图后.将其添加到您的代码中：这将使您的警报视图内部有两个文本字段.

  9. ios – 如何在swift中使用Textfield进行UITableview？

    我想在每个单元格中创建一个带有textfields的表视图,我有一个swift文件中的自定义类：然后在我的ViewController我有这很好：但是当用户在文本框中输入文本并按下按钮时,我想将每个文本框的字符串存储在数组中.我试过了但它没有像空的那样打印出来我该如何让它工作？

  10. 当iOS中的TextField开始输入时,PlaceHolder会动画

    如何在UITextField中设置这种类型的动画？

随机推荐

  1. Angular2 innerHtml删除样式

    我正在使用innerHtml并在我的cms中设置html,响应似乎没问题,如果我这样打印：{{poi.content}}它给了我正确的内容：``但是当我使用[innerHtml]=“poi.content”时,它会给我这个html：当我使用[innerHtml]时,有谁知道为什么它会剥离我的样式Angular2清理动态添加的HTML,样式,……

  2. 为Angular根组件/模块指定@Input()参数

    我有3个根组件,由根AppModule引导.你如何为其中一个组件指定@input()参数？也不由AppModalComponent获取：它是未定义的.据我所知,你不能将@input()传递给bootstraped组件.但您可以使用其他方法来做到这一点–将值作为属性传递.index.html：app.component.ts：

  3. angular-ui-bootstrap – 如何为angular ui-bootstrap tabs指令指定href参数

    我正在使用角度ui-bootstrap库,但我不知道如何为每个选项卡指定自定义href.在角度ui-bootstrap文档中,指定了一个可选参数select(),但我不知道如何使用它来自定义每个选项卡的链接另一种重新定义问题的方法是如何使用带有角度ui-bootstrap选项卡的路由我希望现在还不算太晚,但我今天遇到了同样的问题.你可以通过以下方式实现：1)在控制器中定义选项卡href：2)声明一个函数来改变控制器中的散列：3)使用以下标记：我不确定这是否是最好的方法,我很乐意听取别人的意见.

  4. 离子框架 – 标签内部的ng-click不起作用

    >为什么标签标签内的按钮不起作用？>但是标签外的按钮(登陆)工作正常,为什么？>请帮我解决这个问题.我需要在点击时做出回复按钮workingdemo解决方案就是不要为物品使用标签.而只是使用divHTML

  5. Angular 2：将值传递给路由数据解析

    我正在尝试编写一个DataResolver服务,允许Angular2路由器在初始化组件之前预加载数据.解析器需要调用不同的API端点来获取适合于正在加载的路由的数据.我正在构建一个通用解析器,而不是为我的许多组件中的每个组件设置一个解析器.因此,我想在路由定义中传递指向正确端点的自定义输入.例如,考虑以下路线：app.routes.ts在第一个实例中,解析器需要调用/path/to/resourc

  6. angularjs – 解释ngModel管道,解析器,格式化程序,viewChangeListeners和$watchers的顺序

    换句话说：如果在模型更新之前触发了“ng-change”,我可以理解,但是我很难理解在更新模型之后以及在完成填充更改之前触发函数绑定属性.如果您读到这里：祝贺并感谢您的耐心等待！

  7. 角度5模板形式检测形式有效性状态的变化

    为了拥有一个可以监听其包含的表单的有效性状态的变化的组件并执行某些组件的方法,是reactiveforms的方法吗？

  8. Angular 2 CSV文件下载

    我在springboot应用程序中有我的后端,从那里我返回一个.csv文件WheniamhittingtheURLinbrowsercsvfileisgettingdownloaded.现在我试图从我的角度2应用程序中点击此URL,代码是这样的：零件：服务：我正在下载文件,但它像ActuallyitshouldbeBook.csv请指导我缺少的东西.有一种解决方法,但您需要创建一个页面上的元

  9. angularjs – Angular UI-Grid：过滤后如何获取总项数

    提前致谢：)你应该避免使用jQuery并与API进行交互.首先需要在网格创建事件中保存对API的引用.您应该已经知道总行数.您可以使用以下命令获取可见/已过滤行数：要么您可以使用以下命令获取所选行的数量：

  10. angularjs – 迁移gulp进程以包含typescript

    或者我应该使用tsc作为我的主要构建工具,让它解决依赖关系,创建映射文件并制作捆绑包？

返回
顶部