InputNumber数字输入框

InputNumber数字输入框

通过鼠标或键盘，输入范围内的数值。

何时使用

当需要获取标准数值时。

import { NzInputNumberModule } from 'ng-zorro-antd/input-number';

代码演示

基本

数字输入框。

import { Component } from '@angular/core';
@Component({
  selector: 'nz-demo-input-number-basic',
  template: `
    <nz-input-number [(ngModel)]="demoValue" [nzMin]="1" [nzMax]="10" [nzStep]="1"></nz-input-number>
  `
})
export class NzDemoInputNumberBasicComponent {
  demoValue = 3;
}

不可用

点击按钮切换可用状态。

import { Component } from '@angular/core';
@Component({
  selector: 'nz-demo-input-number-disabled',
  template: `
    <nz-input-number [(ngModel)]="demoValue" [nzMin]="1" [nzMax]="10" [nzStep]="1" [nzDisabled]="isDisabled"></nz-input-number>
    <div style="margin-top:20px;">
      <button nz-button [nzType]="'primary'" (click)="toggleDisabled()">
        <span>Toggle Disabled</span>
      </button>
    </div>
  `
})
export class NzDemoInputNumberDisabledComponent {
  demoValue = 3;
  isDisabled = false;
  toggleDisabled(): void {
    this.isDisabled = !this.isDisabled;
  }
}

格式化展示

通过 nzFormatter 格式化数字，以展示具有具体含义的数据，往往需要配合 nzParser 一起使用。

import { Component } from '@angular/core';
@Component({
  selector: 'nz-demo-input-number-formatter',
  template: `
    <nz-input-number
      [(ngModel)]="demoValue"
      [nzMin]="1"
      [nzMax]="100"
      [nzStep]="1"
      [nzFormatter]="formatterDollar"
      [nzParser]="parserDollar"
    ></nz-input-number>
    <nz-input-number
      [(ngModel)]="demoValue"
      [nzMin]="1"
      [nzMax]="100"
      [nzStep]="1"
      [nzFormatter]="formatterPercent"
      [nzParser]="parserPercent"
    ></nz-input-number>
  `,
  styles: [
    `
      nz-input-number {
        margin-right: 8px;
      }
    `
  ]
})
export class NzDemoInputNumberFormatterComponent {
  demoValue = 100;
  formatterPercent = (value: number) => `${value} %`;
  parserPercent = (value: string) => value.replace(' %', '');
  formatterDollar = (value: number) => `$ ${value}`;
  parserDollar = (value: string) => value.replace('$ ', '');
}

三种大小

三种大小的数字输入框，当 nzSize 分别为 large 和 small 时，输入框高度为 40px 和 24px ，默认高度为 32px。

import { Component } from '@angular/core';
@Component({
  selector: 'nz-demo-input-number-size',
  template: `
    <nz-input-number [(ngModel)]="demoValue" [nzSize]="'large'" [nzMin]="1" [nzMax]="10" [nzStep]="1"></nz-input-number>
    <nz-input-number [(ngModel)]="demoValue" [nzMin]="1" [nzMax]="10" [nzStep]="1"></nz-input-number>
    <nz-input-number [(ngModel)]="demoValue" [nzSize]="'small'" [nzMin]="1" [nzMax]="10" [nzStep]="1"></nz-input-number>
  `,
  styles: [
    `
      nz-input-number {
        margin-right: 8px;
      }
    `
  ]
})
export class NzDemoInputNumberSizeComponent {
  demoValue = 3;
}

小数

和原生的数字输入框一样，value 的精度由 nzStep 的小数位数决定。

import { Component } from '@angular/core';
@Component({
  selector: 'nz-demo-input-number-digit',
  template: `
    <nz-input-number [(ngModel)]="demoValue" [nzMin]="1" [nzMax]="10" [nzStep]="0.1" [nzPlaceHolder]="'Digital'"></nz-input-number>
  `
})
export class NzDemoInputNumberDigitComponent {
  demoValue: number = 0;
}

精度

指定 value 的精度

import { Component } from '@angular/core';
@Component({
  selector: 'nz-demo-input-number-precision',
  template: `
    <nz-input-number [(ngModel)]="toFixedValue" [nzPrecision]="precision" nzPlaceHolder="toFixed"></nz-input-number>
    <nz-input-number [(ngModel)]="cutValue" [nzPrecision]="precision" nzPrecisionMode="cut" nzPlaceHolder="cut off"></nz-input-number>
    <nz-input-number
      [(ngModel)]="customFnValue"
      [nzPrecision]="precision"
      [nzPrecisionMode]="customPrecisionFn"
      nzPlaceHolder="cut off"
    ></nz-input-number>
  `,
  styles: [
    `
      nz-input-number {
        margin-right: 8px;
      }
    `
  ]
})
export class NzDemoInputNumberPrecisionComponent {
  toFixedValue = 2;
  cutValue = 2;
  customFnValue = 2;
  precision = 2;
  customPrecisionFn(value: string | number, precision?: number): number {
    return +Number(value).toFixed(precision! + 1);
  }
}

API

nz-input-numbercomponent

成员	说明	类型	默认值
`[ngModel]`	当前值，可双向绑定	`number \| string` \| `string`	-
`[nzAutoFocus]`	自动获取焦点	`boolean`	`false`
`[nzDisabled]`	禁用	`boolean`	`false`
`[nzMax]`	最大值	`number`	`Infinity`
`[nzMin]`	最小值	`number`	`-Infinity`
`[nzFormatter]`	指定输入框展示值的格式	`(value: number \| string) => string \| number`	-
`[nzParser]`	指定从 nzFormatter 里转换回数字的方式，和 nzFormatter 搭配使用	`(value: string) => string \| number`	`(value: string) => value.trim().replace(/。/g, ‘.’).replace(/[^\w.-]+/g, ‘’)`
`[nzPrecision]`	数值精度	`number`	-
`[nzPrecisionMode]`	数值精度的取值方式	`‘cut’ \| ‘toFixed’ \| ((value: number \| string, precision?: number) => number)`	`‘toFixed’`
`[nzSize]`	输入框大小	`‘large’ \| ‘small’ \| ‘default’`	`‘default’`
`[nzStep]`	每次改变步数，可以为小数	`number \| string`	`1`
`[nzInputMode]`	提供了用户在编辑元素或其内容时可能输入的数据类型的提示，详见MDN	`string`	`decimal`
`[nzPlaceHolder]`	选择框默认文字	`string`	-
`[nzId]`	组件内部 input 的 id 值	`string`	-
`(ngModelChange)`	数值改变时回调	`EventEmitter<number>`	-
`(nzFocus)`	focus时回调	`EventEmitter<void>`	-
`(nzBlur)`	blur时回调	`EventEmitter<void>`	-

方法

通过 ViewChild 等方法获得实例后调用

名称	描述
focus()	获取焦点
blur()	移除焦点