openplanning

Hướng dẫn và ví dụ Flutter NumberTextInputFormatter

  1. Cài đặt thư viện
  2. NumberTextInputFormatter
  3. CurrencyTextInputFormatter
  4. PercentageTextInputFormatter
Khi phát triển một ứng dụng Flutter rất thường xuyên bạn phải tạo một trường đầu vào văn bản để thu thập dữ liệu từ người dùng, cụ thể là TextField. Các TextInputFormatter(s) được sử dụng để định dạng lại văn bản mà người dùng đã nhập và hiển thị nó theo cách thân thiện hơn, chúng cũng thêm hoặc loại bỏ các ký tự không hợp lệ.
TextField(
  controller: textEditingController,
  decoration: const InputDecoration(
    border: OutlineInputBorder(
      borderSide: BorderSide(
        color: Colors.greenAccent,
        width: 0.4,
      ),
    ),
  ),
  inputFormatters: [
    // TextInputFormatter(s) Here!
  ],
)
  • Flutter TextInputFormatter
Để đảm bảo rằng người dùng sẽ nhập vào một văn bản số hợp lệ bạn có thể sử dụng gói thư viện Flutter number_text_input_formatter. Thư viện này cung cấp một vài TextInputFormatter(s) hữu ích sau:
  • NumberTextInputFormatter
  • CurrencyTextInputFormatter
  • PercentageTextInputFormatter

1. Cài đặt thư viện

pubspec.yaml
dependencies:
  number_text_input_formatter: ^1.0.0+8

2. NumberTextInputFormatter

NumberTextInputFormatter là một lớp con của TextInputFormatter, nó giúp loại bỏ các ký tự không phải là một con số (digit) khi người dùng nhập vào TextField/TextFormField và chấp nhận ký tự dấu trừ cho trường hợp số âm. NumberTextInputFormatter tự động định dạng văn bản số thành các nhóm khác nhau.
NumberTextInputFormatter Constructor (*)
NumberTextInputFormatter({
  String? prefix,
  String? suffix,
  int? integerDigits,
  int? decimalDigits,
  String? maxValue,
  String decimalSeparator = '.',
  int? groupDigits,
  String groupSeparator = ',',
  bool allowNegative = false,
  bool overrideDecimalPoint = false,
  bool fixNumber = true,
  bool insertDecimalPoint = false,
  bool insertDecimalDigits = false,
});
Ví dụ:
main_number_ex1.dart
import 'package:flutter/material.dart';
import 'package:number_text_input_formatter/number_text_input_formatter.dart';

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

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  late TextEditingController textEditingController;
  late NumberTextInputFormatter numberTextInputFormatter;

  @override
  void initState() {
    numberTextInputFormatter = NumberTextInputFormatter(
      integerDigits: 10,
      decimalDigits: 2,
      maxValue: '1000000000.00',
      decimalSeparator: '.',
      groupDigits: 3,
      groupSeparator: ',',
      allowNegative: false,
      overrideDecimalPoint: true,
      insertDecimalPoint: false,
      insertDecimalDigits: true,
    );

    double initialValue = 12345.21;
    TextEditingValue value = numberTextInputFormatter.formatEditUpdate(
      const TextEditingValue(),
      TextEditingValue(text: initialValue.toString()),
    );

    textEditingController = TextEditingController(text: value.text);

    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: const Text("Flutter NumberTextInputFormatter"),
      ),
      body: Padding(
        padding: const EdgeInsets.all(10),
        child: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              const Text('Enter a number:'),
              const SizedBox(height: 10),
              TextField(
                controller: textEditingController,
                decoration: const InputDecoration(
                  border: OutlineInputBorder(
                    borderSide: BorderSide(
                      color: Colors.greenAccent,
                      width: 0.4,
                    ),
                  ),
                ),
                inputFormatters: [
                  numberTextInputFormatter,
                ],
              )
            ],
          ),
        ),
      ),
    );
  }
}

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: 'Flutter Demo',
      debugShowCheckedModeBanner: false,
      home: MyHomePage(),
    );
  }
}

3. CurrencyTextInputFormatter

CurrencyTextInputFormatter là một lớp con của NumberTextInputFormatter, nó hỗ trợ các trường đầu vào tiền tệ. CurrencyTextInputFormatter có thêm 2 tham số là prefix & suffix so với lớp cha của nó.
CurrencyTextInputFormatter Constructor (*)
CurrencyTextInputFormatter({
  String? prefix,
  String? suffix,
  int? integerDigits,
  int decimalDigits = 2,
  String? maxValue,
  bool allowNegative = false,
  String decimalSeparator = '.',
  int groupDigits = 3,
  String groupSeparator = ',',
  bool overrideDecimalPoint = false,
  bool insertDecimalPoint = true,
  bool insertDecimalDigits = false,
});
Ví dụ:
main_currency_ex1.dart (*)
currencyTextInputFormatter = CurrencyTextInputFormatter(
  prefix: "\$",
  integerDigits: 10,
  decimalDigits: 2,
  maxValue: '1000000000.00',
  decimalSeparator: '.',
  groupDigits: 3,
  groupSeparator: ',',
  allowNegative: false,
  overrideDecimalPoint: true,
  insertDecimalPoint: false,
  insertDecimalDigits: true,
);
Ví dụ 2:
main_currency_ex2.dart (*)
currencyTextInputFormatter = CurrencyTextInputFormatter(
  suffix: " VND",
  integerDigits: 10,
  decimalDigits: 2,
  maxValue: '1000000000.00',
  decimalSeparator: '.',
  groupDigits: 3,
  groupSeparator: ',',
  allowNegative: false,
  overrideDecimalPoint: true,
  insertDecimalPoint: false,
  insertDecimalDigits: true,
);

4. PercentageTextInputFormatter

PercentageTextInputFormatter là một lớp con của NumberTextInputFormatter, nó hỗ trợ các trường đầu vào tiền tệ. PercentageTextInputFormatter có thêm 2 tham số là prefix & suffix so với lớp cha của nó.
PercentageTextInputFormatter Constructor (*)
PercentageTextInputFormatter({
  String? prefix,
  String? suffix,
  int integerDigits = 3,
  int decimalDigits = 0,
  bool allowNegative = false,
  String decimalSeparator = '.',
  int? groupDigits,
  String groupSeparator = ',',
  bool overrideDecimalPoint = false,
  bool insertDecimalPoint = false,
  bool insertDecimalDigits = true,
});
Giá trị lớn nhất mà người dùng có thể nhập vào đã được chỉ định dựa trên công thức sau:
maxValue: '1${'0' * (integerDigits - 1)}${decimalDigits > 0 ? '.${'0' * decimalDigits}' : ''}',
Ví dụ: Một trường đầu vào cho phép người dùng nhập vào một giá trị phần trăm không lớn hơn 100%.
main_percentage_ex1.dart (*)
percentageTextInputFormatter = PercentageTextInputFormatter(
  suffix: '%',
  integerDigits: 3,
  decimalDigits: 1,
  decimalSeparator: '.',
  groupDigits: 3,
  groupSeparator: ',',
  allowNegative: false,
  overrideDecimalPoint: true,
  insertDecimalPoint: false,
  insertDecimalDigits: true,
);

double initialValue = 12.2;
TextEditingValue value = percentageTextInputFormatter.formatEditUpdate(
  const TextEditingValue(),
  TextEditingValue(text: initialValue.toString()),
);

textEditingController = TextEditingController(text: value.text);

Các hướng dẫn lập trình Flutter

Show More