Flutter内置键盘管理插件built_in_keyboard的使用

Flutter内置键盘管理插件built_in_keyboard的使用

built_in_keyboard 是一个用于在 Flutter 应用中添加内置键盘而不是系统键盘的包。该实现依赖于 textInputField 并通过 TextEditingController 进行交互。

使用

首先，在您的项目中添加该包，并运行 flutter pub get。

dependencies:
  built_in_keyboard:
    git:
      url: https://github.com/Open-pi/builtinkeyboard.git
      ref: main

使用 BuiltInKeyboard 小部件，您可以轻松更改键盘布局、按键外观等。

以下是一些可更改的属性。请记住，控制器是必需的，以使键盘正常工作。

BuiltInKeyboard(
  controller: this.textController, // 必须
  language: Language.DE, // 可选
  layout: Layout.QWERTZ, // 可选，但如果您修改了语言，则必须检查！
  enableSpaceBar: true, // 可选，添加空格键
  enableBackSpace: true, // 可选，添加退格按钮
  enableCapsLock: true, // 可选，添加大写锁定按钮
  borderRadius: BorderRadius.circular(8.0), // 更改键的边框半径
  letterStyle: TextStyle(fontSize: 25, color: Colors.black) // 更改键内文字样式
)

额外选项和标志

示例代码

以下是完整的示例代码：

import 'package:built_in_keyboard/language.dart';
import 'package:flutter/material.dart';
import 'package:built_in_keyboard/built_in_keyboard.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '内置键盘测试',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: '内置键盘测试首页'),
    );
  }
}

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

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    TextEditingController textController = TextEditingController();
    return Scaffold(
      appBar: AppBar(
        title: Text('内置键盘'),
        centerTitle: true,
        backgroundColor: Colors.deepOrange,
      ),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          Spacer(),
          Padding(
            padding: const EdgeInsets.fromLTRB(10.0, 10.0, 10.0, 0.0),
            child: TextFormField(
              controller: textController,
              readOnly: true,
              keyboardType: TextInputType.name,
              style: TextStyle(
                fontWeight: FontWeight.bold,
                color: Colors.indigo[900],
                fontSize: 22.0,
              ),
              decoration: InputDecoration(
                contentPadding: EdgeInsets.fromLTRB(21.0, 0.0, 0.0, 0.0),
                filled: true,
                enabledBorder: OutlineInputBorder(
                  borderRadius: BorderRadius.circular(25.0),
                  borderSide: BorderSide(width: 3.0, color: Colors.deepOrange),
                ),
                focusedBorder: OutlineInputBorder(
                  borderRadius: BorderRadius.circular(25.0),
                  borderSide: BorderSide(width: 3.0, color: Colors.deepOrange),
                ),
                hintText: '尝试一下...',
                hintStyle: TextStyle(fontSize: 20, fontWeight: FontWeight.w700),
                floatingLabelBehavior: FloatingLabelBehavior.always,
              ),
            ),
          ),
          Spacer(),
          Padding(
            padding: EdgeInsets.only(bottom: 3),
            child: BuiltInKeyboard(
              language: Language.EN,
              layout: Layout.QWERTY,
              borderRadius: BorderRadius.circular(8),
              controller: textController,
              enableLongPressUppercase: true,
              enableSpaceBar: true,
              enableBackSpace: true,
              enableCapsLock: true,
            ),
          ),
        ],
      ),
    );
  }
}