在 Flutter 中自定义数字键盘

2024-01-03 10:52:49

在 Flutter 中创建自定义数字键盘、限制用户输入并格式化输入值

前言

在移动应用程序开发中，提供直观且用户友好的文本输入体验至关重要。Flutter 中的 TextInput 类提供了广泛的文本编辑功能，但有时我们需要更定制化的输入体验，例如自定义键盘布局、限制用户输入或格式化输入值。

创建自定义数字键盘

RawKeyboard 类允许我们定义键盘上的键及其行为。通过将 RawKeyboardRow 和 RawKeyboardKey 组合在一起，我们可以创建自定义的键盘布局。例如，下面是创建一个数字键盘的示例代码：

RawKeyboard(
  children: [
    RawKeyboardRow(
      children: [
        RawKeyboardKey(keyLabel: '1', onPrimaryKey: () => TextInput.insertText('1')),
        RawKeyboardKey(keyLabel: '2', onPrimaryKey: () => TextInput.insertText('2')),
        RawKeyboardKey(keyLabel: '3', onPrimaryKey: () => TextInput.insertText('3')),
      ],
    ),
    // 更多行和键...
  ],
);

限制用户输入

TextInputFormatter 类提供了一组预定义的格式化器，用于限制用户输入的类型。例如，TextInputFormatter.digitsOnly 只能输入数字。也可以创建自定义格式化器以实现更复杂的限制。

TextInputFormatter.digitsOnly

格式化输入值

SmartDateTextInputFormatter、NumberTextInputFormatter 和 PhoneTextInputFormatter 等类提供预定义的格式，用于将输入值格式化为日期、数字或电话号码。

示例：安全 PIN 输入

为了演示这些概念，让我们考虑一个使用自定义数字键盘和限制输入长度的示例。该键盘用于输入安全 PIN 码，最多 4 位数字。

代码示例：

final _pinController = TextEditingController();
final _pinFormatter = TextInputFormatter.digitsOnly;

RawKeyboard(
  children: [
    RawKeyboardRow(
      children: [
        RawKeyboardKey(keyLabel: '1', onPrimaryKey: () => _pinController.insertText(0, '1')),
        // 更多键...
      ],
    ),
  ],
);

TextField(
  controller: _pinController,
  keyboardType: TextInputType.number,
  inputFormatters: [_pinFormatter],
  maxLength: 4,
  decoration: InputDecoration(hintText: 'Enter PIN'),
);