Flutter键盘管理插件flutter_keyboard的使用

flutter_keyboard 是一个易于使用的Flutter插件，它可以在您的应用中显示类似于POS设备上的数字键盘。该插件支持Android、iOS、Web、Windows、Linux和Mac平台。

安装

在您的 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  flutter_keyboard: ^2.0.0

然后运行 flutter pub get 来安装插件，并在需要的地方导入：

import 'package:flutter_keyboard/flutter_keyboard.dart';

如何使用

创建一个 FlutterKeyboard 小部件并传递必要的参数即可使用：

FlutterKeyboard(
  onKeyboardTap: _onKeyboardTap,
)

定义 _onKeyboardTap 方法来处理按键事件：

void _onKeyboardTap(String value) {
  setState(() {
    text += value;
  });
}

参数说明

以下是 FlutterKeyboard 支持的所有参数示例：

FlutterKeyboard(
  onKeyboardTap: _onKeyboardTap,
  characters: const ['1', '2', '3', 'A', 'B', 'C', '!', '@', '#'],
  footerMiddleCharacter: '💡',
  itemsPerRow: 3,
  getAllSpace: true,
  externalPaddingButtons: const EdgeInsets.all(12),
  buttonsDecoration: BoxDecoration(
    borderRadius: BorderRadius.circular(12),
    color: Colors.blue,
  ),
  footerRightAction: () {
    setState(() {
      textCtrl.text = textCtrl.text.substring(0, textCtrl.text.length - 1);
    });
  },
  footerRightChild: Container(
    alignment: Alignment.center,
    width: 50,
    height: 50,
    child: const Icon(Icons.backspace),
  ),
  footerLeftAction: () {},
  footerLeftChild: Container(
    alignment: Alignment.center,
    width: 50,
    height: 50,
    child: const Icon(Icons.done),
  ),
)

示例Demo

下面是一个完整的示例代码，展示了如何在Flutter项目中集成和使用 flutter_keyboard 插件：

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

void main() => runApp(const MyApp());

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Keyboard Example',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Keyboard Example'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  TextEditingController textCtrl = TextEditingController();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.end,
        crossAxisAlignment: CrossAxisAlignment.center,
        children: <Widget>[
          TextField(
            controller: textCtrl,
            enabled: false,
          ),
          FlutterKeyboard(
            onKeyboardTap: _onKeyboardTap,
            characters: const ['1', '2', '3', 'A', 'B', 'C', '!', '@', '#'],
            footerMiddleCharacter: '💡',
            itemsPerRow: 3,
            getAllSpace: true,
            externalPaddingButtons: const EdgeInsets.all(12),
            buttonsDecoration: BoxDecoration(
              borderRadius: BorderRadius.circular(12),
              color: Colors.blue,
            ),
            footerRightAction: () {
              setState(() {
                textCtrl.text = textCtrl.text.substring(0, textCtrl.text.length - 1);
              });
            },
            footerRightChild: Container(
              alignment: Alignment.center,
              width: 50,
              height: 50,
              child: const Icon(Icons.backspace),
            ),
            footerLeftAction: () {},
            footerLeftChild: Container(
              alignment: Alignment.center,
              width: 50,
              height: 50,
              child: const Icon(Icons.done),
            ),
          ),
        ],
      ),
    );
  }

  void _onKeyboardTap(String value) {
    setState(() {
      textCtrl.text += value;
    });
  }
}