You need to enable JavaScript to run this app. Flutter 如何在TextField内实现货币输入每三位数字添加千分位逗号
优惠活动
大模型
产品
解决方案
定价
更多

Flutter 如何在TextField内实现货币输入每三位数字添加千分位逗号

韩元输入框千分位自动格式化实现

核心实现逻辑

要实现输入自动加千分位逗号的效果,不能直接在onChanged里修改文本,需要配合TextEditingController完成四件事:

  • 拦截所有输入内容,过滤掉非数字的非法字符,保证输入框只接收数字
  • 把纯数字内容按照每三位的规则加逗号,生成格式化的展示文本
  • 修正格式化后的光标位置,避免光标错位跳到文本末尾
  • 单独存储不带逗号的纯数字金额,供后续业务计算、提交使用,不要直接读取带逗号的展示文本做数值运算

完整代码实现

首先在pubspec.yaml引入数字格式化依赖:

dependencies:
  intl: ^0.19.0 # 替换为和项目匹配的最新稳定版本即可

然后替换原来的TextFormField实现如下:

import 'package:flutter/material.dart';
import 'package:intl/intl.dart';

class WonAmountInput extends StatefulWidget {
  const WonAmountInput({super.key});

  @override
  State<WonAmountInput> createState() => _WonAmountInputState();
}

class _WonAmountInputState extends State<WonAmountInput> {
  // 存储纯数字格式的实际金额,不带任何逗号
  String _actualAmount = '';
  late final TextEditingController _inputController;
  // 千分位格式化规则:从右往左每3位数字加逗号分隔
  final NumberFormat _numberFormatter = NumberFormat('#,###', 'en_US');

  @override
  void initState() {
    super.initState();
    _inputController = TextEditingController();
    // 监听输入变化,自动触发格式化逻辑
    _inputController.addListener(_handleInputFormat);
  }

  @override
  void dispose() {
    _inputController.removeListener(_handleInputFormat);
    _inputController.dispose();
    super.dispose();
  }

  void _handleInputFormat() {
    // 先把当前输入内容里的逗号全部移除,只保留原始数字
    String rawInput = _inputController.text.replaceAll(',', '');
    // 过滤所有非数字字符,拦截非法输入
    rawInput = rawInput.replaceAll(RegExp(r'[^0-9]'), '');

    // 空输入/0输入时直接清空展示
    if (rawInput.isEmpty || rawInput == '0') {
      setState(() {
        _actualAmount = '';
        _inputController.value = const TextEditingValue(
          text: '',
          selection: TextSelection.collapsed(offset: 0),
        );
      });
      return;
    }

    // 生成带千分位逗号的展示文本
    int amountNumber = int.parse(rawInput);
    String displayText = _numberFormatter.format(amountNumber);

    // 计算正确的光标偏移:由于插入了逗号,需要把光标位置对应到正确的输入位置
    int oldCursorOffset = _inputController.selection.baseOffset;
    // 统计光标位置之前插入了多少个逗号,计算新的光标位置
    int commaCount = 0;
    for (int i = 0; i < oldCursorOffset; i++) {
      if (i < rawInput.length && (i + 1) % 3 == 0) {
        commaCount++;
      }
    }
    int newCursorOffset = oldCursorOffset + commaCount;
    // 防止光标位置超出文本总长度
    if (newCursorOffset > displayText.length) {
      newCursorOffset = displayText.length;
    }

    setState(() {
      _actualAmount = rawInput;
      // 写入格式化后的文本和正确的光标位置
      _inputController.value = TextEditingValue(
        text: displayText,
        selection: TextSelection.collapsed(offset: newCursorOffset),
      );
    });
  }

  @override
  Widget build(BuildContext context) {
    return TextFormField(
      controller: _inputController,
      keyboardType: TextInputType.number,
      decoration: const InputDecoration(
        hintText: '예) 10,000 원',
        // 直接把韩元单位放到输入框后缀,和参考效果对齐
        suffixText: '원',
      ),
      onChanged: (value) {
        // _actualAmount 就是不带逗号的纯数字金额,直接传给业务逻辑使用即可
        debugPrint('实际提交金额:$_actualAmount');
      },
    );
  }
}

补充说明

  • 如果不想引入intl第三方依赖,可以自己实现千分位格式化逻辑,替换掉格式化步骤的代码即可:
String formatWithComma(String pureNumberStr) {
  if (pureNumberStr.length <= 3) return pureNumberStr;
  List<String> segmentList = [];
  int endIndex = pureNumberStr.length;
  while (endIndex > 0) {
    int startIndex = endIndex - 3 >=0 ? endIndex -3 : 0;
    segmentList.add(pureNumberStr.substring(startIndex, endIndex));
    endIndex = startIndex;
  }
  return segmentList.reversed.join(',');
}
  • 注意不要直接把输入框里带逗号的展示文本转成数值参与计算,必须用去掉逗号的_actualAmount值处理,否则会出现类型转换报错。

内容的提问来源于stack exchange,提问作者Hee

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 19:06:06