Flutter密码输入插件pin_entry_text_field的使用

发布于 1周前 作者 ionicwang 来自 Flutter

Flutter密码输入插件pin_entry_text_field的使用

👏 PinEntryTextField
这是一个完全可自定义的PIN输入文本框。

源代码为 100% Dart,所有文件都位于 /lib 文件夹中。

Show some ❤️ 和 star 支持项目

GIF


💻 安装

pubspec.yaml 文件的 dependencies: 部分添加以下行:

pin_entry_text_field: ^0.1.3

当前版本:^0.1.3

❔ 使用

导入这个类

import 'package:pin_entry_text_field/pin_entry_text_field.dart';

在任何需要获取PIN或OTP的地方使用该小部件,唯一必需的属性是 onSubmit 回调

[@override](/user/override)
Widget build(BuildContext context) {
  return Scaffold(
    body: PinEntryTextField(
      onSubmit: (String pin) {
        showDialog(
          context: context,
          builder: (context) {
            return AlertDialog(
              title: Text("Pin"),
              content: Text('Pin entered is $pin'),
            );
          },
        ); // end showDialog()
      }, // end onSubmit
    ),
  );
}

🎨 自定义和属性

以下是 PinEntryTextField 的所有可定制属性:

属性名称 示例值 描述
fields 4 指定生成的文本框数量,默认为4
onSubmit (String returnedPin){} 当用户输入最后一个PIN或按下完成键时触发回调,返回输入的PIN
fieldWidth 40.0 每个文本框的大小,默认为40.0
fontSize 20.0 文本框字体大小,默认为20.0
isTextObscure false 是否隐藏文本框中的字符,默认为false
showFieldAsBox false 确定文本框是否有边框还是只有底部下划线

👍 如何贡献

  1. Fork 该项目
  2. 创建新的功能分支 (git checkout -b my-new-feature)
  3. 提交更改 (git commit -am 'Add some feature')
  4. 推送到分支 (git push origin my-new-feature)
  5. 创建新的 Pull Request

📃 许可证

Copyright (c) 2018 Godson Ositadinma

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Getting Started

对于如何开始使用Flutter,请查看我们的在线 文档

对于如何编辑包代码,请查看 文档


完整示例代码

以下是一个完整的示例代码,展示如何使用 pin_entry_text_field 插件:

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

class ExamplePinEntry extends StatelessWidget {

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("Pin Entry Example"),
      ),
      body: Container(
        child: Padding(
          padding: const EdgeInsets.all(8.0),
          child: PinEntryTextField(
            showFieldAsBox: true, // 设置为true后,每个文本框会显示为矩形框
            onSubmit: (String pin) {
              // 当用户输入PIN后触发此回调
              showDialog(
                context: context,
                builder: (context) {
                  return AlertDialog(
                    title: Text("Pin"),
                    content: Text('Pin entered is $pin'), // 显示用户输入的PIN
                  );
                },
              ); // 结束对话框
            }, // 结束onSubmit
          ), // 结束PinEntryTextField
        ), // 结束Padding
      ), // 结束Container
    );
  }
}

更多关于Flutter密码输入插件pin_entry_text_field的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter密码输入插件pin_entry_text_field的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


pin_entry_text_field 是一个用于 Flutter 的插件,专门用于处理密码或验证码的输入。它提供了一个美观且易于使用的界面,允许用户输入固定长度的数字或字符。以下是如何在 Flutter 项目中使用 pin_entry_text_field 插件的详细步骤。

1. 添加依赖

首先,你需要在 pubspec.yaml 文件中添加 pin_entry_text_field 插件的依赖。

dependencies:
  flutter:
    sdk: flutter
  pin_entry_text_field: ^1.0.0

然后运行 flutter pub get 来安装依赖。

2. 导入插件

在你的 Dart 文件中导入 pin_entry_text_field 插件。

import 'package:pin_entry_text_field/pin_entry_text_field.dart';

3. 使用 PinEntryTextField

PinEntryTextField 是插件提供的主要组件。你可以通过设置一些属性来定制它的外观和行为。

以下是一个简单的示例,展示了如何使用 PinEntryTextField

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

class PinEntryExample extends StatefulWidget {
  @override
  _PinEntryExampleState createState() => _PinEntryExampleState();
}

class _PinEntryExampleState extends State<PinEntryExample> {
  String _pin = '';

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Pin Entry Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            PinEntryTextField(
              fields: 6, // 设置输入框的数量
              onSubmit: (String pin) {
                setState(() {
                  _pin = pin;
                });
                print("Entered PIN: $pin");
              },
            ),
            SizedBox(height: 20),
            Text(
              'Entered PIN: $_pin',
              style: TextStyle(fontSize: 18),
            ),
          ],
        ),
      ),
    );
  }
}

void main() => runApp(MaterialApp(
  home: PinEntryExample(),
));

4. 主要属性

PinEntryTextField 提供了多个属性来定制其外观和行为:

  • fields: 输入框的数量,默认为 4。
  • onSubmit: 当用户完成输入时调用的回调函数,返回输入的字符串。
  • fieldWidth: 每个输入框的宽度,默认为 40.0。
  • fieldHeight: 每个输入框的高度,默认为 40.0。
  • textStyle: 输入框中文本的样式。
  • isTextObscure: 是否隐藏输入的文本(用于密码输入),默认为 false
  • showFieldAsBox: 是否将输入框显示为方框,默认为 true
  • activeColor: 当前活动输入框的颜色。
  • inactiveColor: 非活动输入框的颜色。
  • keyboardType: 键盘类型,默认为 TextInputType.number

5. 自定义样式

你可以通过设置 textStyleactiveColorinactiveColor 等属性来自定义 PinEntryTextField 的外观。

PinEntryTextField(
  fields: 4,
  onSubmit: (String pin) {
    print("Entered PIN: $pin");
  },
  fieldWidth: 50.0,
  fieldHeight: 50.0,
  textStyle: TextStyle(fontSize: 20, color: Colors.black),
  activeColor: Colors.blue,
  inactiveColor: Colors.grey,
  showFieldAsBox: true,
  isTextObscure: true,
);

6. 处理输入

onSubmit 回调函数会在用户完成输入时触发,你可以在其中处理输入的 PIN 码或验证码。

PinEntryTextField(
  fields: 4,
  onSubmit: (String pin) {
    // 处理输入的 PIN 码
    if (pin == "1234") {
      print("Correct PIN");
    } else {
      print("Incorrect PIN");
    }
  },
);
回到顶部
AI 助手
你好,我是IT营的 AI 助手
您可以尝试点击下方的快捷入口开启体验!