# ez-number-input



<!-- Auto Generated Below -->


## Properties

| Property                 | Attribute                 | Description                                                                                                            | Type                  | Default     |
| ------------------------ | ------------------------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------- | ----------- |
| `allowNegative`          | `allow-negative`          | Se false, o input não aceitará números negativos.                                                                      | `boolean`             | `true`      |
| `alternativePlaceholder` | `alternative-placeholder` | Texto alternativo a ser apresentado como título do campo.                                                              | `string`              | `undefined` |
| `autoFocus`              | `auto-focus`              | Se true o campo de texto receberá o foco ao ser renderizado.                                                           | `boolean`             | `false`     |
| `canShowError`           | `can-show-error`          | Se false deixa de exibir a mensagem de erro dentro do campo.                                                           | `boolean`             | `true`      |
| `enabled`                | `enabled`                 | Se false, o usuário não pode interagir com o campo.                                                                    | `boolean`             | `true`      |
| `errorMessage`           | `error-message`           | Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.                                      | `string`              | `undefined` |
| `label`                  | `label`                   | Texto a ser apresentado como título do campo.                                                                          | `string`              | `undefined` |
| `mode`                   | `mode`                    | Define o tamanho do campo.                                                                                             | `"regular" \| "slim"` | `"regular"` |
| `precision`              | `precision`               | Define quantas casas decimais serão exibidas. Caso haja mais casas haverá arredondamento.                              | `number`              | `undefined` |
| `prettyPrecision`        | `pretty-precision`        | Define qual é o mínimo de casas depois da vírgula. Exemplo: 1,1 será exibido como 1,1000 quando `prettyPrecision = 4`. | `number`              | `undefined` |
| `value`                  | `value`                   | Define o valor do campo.                                                                                               | `number`              | `undefined` |


## Events

| Event                   | Description                                                                                    | Type                         |
| ----------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------- |
| `ezCancelWaitingChange` | Emitido quando não foi possível completar a alteração entre o evento ezStartChange e ezChange. | `CustomEvent<void>`          |
| `ezChange`              | Emitido quando acontece a alteração de valor do campo.                                         | `CustomEvent<number>`        |
| `ezInput`               | Emitido quando o usuário digita no campo.                                                      | `CustomEvent<number>`        |
| `ezStartChange`         | Emitido ao iniciar a alteração (digitação incompleta).                                         | `CustomEvent<WaitingChange>` |


## Methods

### `getValueAsync() => Promise<number>`



#### Returns

Type: `Promise<number>`

---

### `isInvalid() => Promise<boolean>`

Retorna se o conteúdo é inválido.

#### Returns

Type: `Promise<boolean>`

---

### `setBlur() => Promise<void>`

Remove o foco do campo.

#### Returns

Type: `Promise<void>`

---

### `setFocus(options?: TFocusOptions) => Promise<void>`

Aplica o foco no campo.

#### Returns

Type: `Promise<void>`




## Dependencies

### Used by

 - [ez-form-view](../ez-form-view)

### Depends on

- [ez-text-input](../ez-text-input)

### Graph
```mermaid
graph TD;
  ez-number-input --> ez-text-input
  ez-text-input --> ez-tooltip
  ez-text-input --> ez-icon
  ez-form-view --> ez-number-input
  style ez-number-input fill:#f9f,stroke:#333,stroke-width:4px
```

----------------------------------------------




## CSS Variables
| Variable  | Description | 
 |-|-|
| --ez-number-input\_\_min-width | Define a largura maxima do componente. | 
| --ez-number-input\_\_max-width | Define a largura minima do componente. |