Buscar pacotes, repositórios e categorias de apps

ducafecatGuia do ecossistema Flutter
Detalhes do pacotev1.0.0+9

number_text_input_formatter

Formatador de Entrada de Texto Numérico para Flutter

AndroidiOSWebmacOSWindowsLinux
pub.dev Documentação da API Código-fonte
Downloads em 30 dias
3
Curtidas
32
Pontos Pub
130

Instalar pacote

flutter pub add number_text_input_formatter

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um pacote Flutter que formata entradas de texto como números, tratando automaticamente pontos decimais, separadores de milhar e sinais negativos. Garante que a entrada do usuário siga convenções numéricas, mantendo um formato limpo e legível nos campos de texto. Ideal para formulários que exigem entrada de dados numéricos, como preços, quantidades ou medidas. O formatador funciona em todas as principais plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux, fornecendo comportamento consistente independentemente do dispositivo. Suporta personalização da precisão decimal e formatação específica por localidade.

Casos de uso

  • Entradas de formulário para preços
  • Entrada de quantidade com formatação
  • Coleta de dados de medição
  • Aplicações financeiras
  • Entrada de número amigável ao usuário
  • Entrada de dados com validação em tempo real

Principais recursos

  • Formato automático de números
  • Suporte para decimais e números negativos
  • Suporte para separador de milhares
  • Precisão decimal personalizável
  • Consistência entre plataformas
  • Formatação consciente de localidade

Indicado para

  • Desenvolvedores de aplicativos financeiros
  • Formulários que exigem entrada numérica
  • Aplicações que precisam de feedback em tempo real de entrada
  • Projetos multiplataforma do Flutter
  • Usuários que preferem entrada de número formatado

Considerações

  • Pode exigir validação adicional para casos extremos
  • Pode interferir na navegação com teclado se não for configurado corretamente
  • Limitado apenas à formatação numérica
  • Não trata caracteres não numéricos por padrão
  • Impacto no desempenho em atualizações de alta frequência

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Number Text Input Formatter

Number Text Input Formatter for Flutter.

Installation

dependencies:
  number_text_input_formatter: ^1.0.0

Usage

NumberTextInputFormatter

General-purpose formatter for numeric input fields.

TextField(
  inputFormatters: [
    NumberTextInputFormatter(
      integerDigits: 10,
      decimalDigits: 2,
      maxValue: '1000000000.00',
      decimalSeparator: '.',
      groupDigits: 3,
      groupSeparator: ',',
      allowNegative: false,
      overrideDecimalPoint: true,
      insertDecimalPoint: false,
      insertDecimalDigits: true,
    ),
  ],
  keyboardType: TextInputType.number,
),
Parameters
Parameter Type Default Description
integerDigits int? null Maximum number of integer digits. Must be > 0 if provided.
decimalDigits int? null Maximum number of decimal digits. Must be >= 0 if provided.
maxValue String? null Maximum allowed value (e.g. '9999.99'). Infers integerDigits and decimalDigits if not set.
decimalSeparator String '.' Character used as the decimal point. Must be a single character.
groupDigits int? null Group integer digits every N digits (e.g. 3 for thousands). Must be > 1 if provided.
groupSeparator String ',' Character used as the grouping separator. Must be a single character, different from decimalSeparator.
allowNegative bool false Whether to allow negative numbers.
fixNumber bool true Inserts 0 before a leading decimal point, and 0 after a trailing decimal point.
insertDecimalPoint bool false Automatically inserts the decimal point as the user types (e.g. 123 → 1.23). Requires decimalDigits to be set.
insertDecimalDigits bool false Always appends decimal digits with zeros (e.g. 5 → 5.00). Requires decimalDigits to be set.
overrideDecimalPoint bool false When a second decimal point is typed, moves the decimal point to the new position instead of ignoring it.
prefix String? null String prepended to the formatted value (e.g. '\$ ').
suffix String? null String appended to the formatted value (e.g. ' USD').
CurrencyTextInputFormatter

Pre-configured formatter for currency input. Defaults: 2 decimal digits, grouping every 3 digits, decimal point auto-inserted.

TextField(
  inputFormatters: [
    CurrencyTextInputFormatter(
      prefix: '\$ ',
    ),
  ],
  keyboardType: TextInputType.number,
),
Parameters

Same as NumberTextInputFormatter with these defaults:

Parameter Default
decimalDigits 2
groupDigits 3
insertDecimalPoint true
PercentageTextInputFormatter

Pre-configured formatter for percentage input. Defaults: max 100, 0 decimal digits, decimal digits always inserted.

TextField(
  inputFormatters: [
    PercentageTextInputFormatter(
      suffix: '%',
    ),
  ],
  keyboardType: TextInputType.number,
),
Parameters

Same as NumberTextInputFormatter with these defaults:

Parameter Default
integerDigits 3 (minimum 3)
decimalDigits 0
insertDecimalDigits true

The maxValue is automatically computed from integerDigits and decimalDigits (e.g. integerDigits: 3 → max 100).

Categorias

Formato automático, Máscara e Validação

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.