Flutter系列：2.实现一个简单的登陆界面

前言

上一篇文章Flutter系列：1.开发环境配置已经配置好了基本的开发环境，那么这篇将直入主题，实现一个简单的登陆页面，实现输入用户名密码点击登陆后验证输入有效性，模拟调用api登陆，最终弹窗提示登陆成功。

本示例代码在这里Github.

tips: 在开始前，你应该快速了解下dart的 基本语法

布局

本示例算是一个比较常见的简单app页面，包括顶部的一个导航栏及其title, 而后一个白底的页面，从上到下依次是一个图片显示控件，用户名和密码的文本输入控件，以及一个提交的按钮。

布局方式

在开始Flutter布局前，心中应该始终记住一个概念，那就是在Flutter布局中显示的都是Widget，包括看得见页面、图片、输入框、按钮...其余看不见的列布局控件('Column'), 容器布局控件('Container')、('SizedBox'),用户表单显示的控件('Form') 甚至用做填充的控件('Padding'), 居中的控件('Center');

• 从main函数开始

void main() {
  debugPaintSizeEnabled = false;
  runApp(new LoginAlertDemoApp());
}

class LoginAlertDemoApp extends StatelessWidget {
  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return new MaterialApp(
        title: 'Login Alert',
        theme: new ThemeData(
          primarySwatch: Colors.blue,
        ),
        home: Scaffold(
          appBar: AppBar(
            title: Text('Login Alert'),
          ),
          body: new LoginHomePage(),
        ));
  }
}

main函数顾名思义，就是app运行的入口，debugPaintSizeEnabled是用户调试显示的；而后是调用sdk的runApp方法，传入一个Widget对象并将它显示到屏幕上，因此此Widget即是APP显示的基础Widget，有点至关于iOS开发中的rootViewController来负责承载整个APP的显示。

在此示例中传入runApp方法的这个Widget是LoginAlertDemoApp，继承自StatelessWidget；重写了其build方法建立了一个MaterialApp的Widget。也就是说主要负责显示的就是MaterialApp的对象，它是用于实现谷歌设计的一套material design设计风格的基础显示Widget，封装了一系列的经常使用组件和导航控制，好比主题控制。从代码能够看到其home属性是一个Scaffold对象，Scaffold也是material design的基础组件之一，实现基本页面布局结构，好比页面导航栏，同时也封装了一系列的基础控件，好比'抽屉页'，toast提示，底部sheet提示。基于material design风格的app基本上都是构建在这2个基础控件之上的。

接下来就是咱们本身实现的页面布局了，LoginHomePage继承自StatefulWidget，注意到Widget有StatefulWidget和StatelessWidget之分，简单的理解呢就是StatefulWidget是具备可变状态的Widget,
它须要一个State来保存其生命周期中的一些状态数据，并在数据改变时经过setState通知到Widget及时更新。而StatelessWidget则是无状态的，不须要维护其状态，只是简单的显示。

因此咱们须要_LoginHomePageState来维护LoginHomePage生命周期中的一些状态变化数据，并经过build方法来实时构建LoginHomePage的显示Widget。

基本控件

• Form

页面分析这是一个简单的表单提交页面，可使用'Form'来进行布局，同时也能很方便经过其State属性的validate()方法来实现输入验证和提示。
validate()会调用TextFormField的validator来执行验证。

• Image

用于显示图片的，支持网络图片和本地图片，本地图片须要添加到配置文件中

# To add assets to your application, add an assets section, like this:
  # assets:
  #  - images/a_dot_burr.jpeg
  #  - images/a_dot_ham.jpeg
  assets:
    - images/lake.jpg

• TextFormField

Form中对应的文本输入控件，validator用于验证输入的合法性，当验证不经过时返回一个字符串提示在输入框的底部。

• RaisedButton

按钮，没什么好说的，onPressed指定点击回调

• Column

列布局，此demo中各控件从上到下依次布局，Column再合适不过了。

• 弹窗

调用AlertDialog显示一个文本的Widget。

第三方组件

此demo中使用了一个第三方的加载提示组件flutter_spinkit

main.dart顶部代码

import 'package:flutter_spinkit/flutter_spinkit.dart';

这是引入的一个第三方加载提示组件flutter_spinkit，使用第三方组件前须要先到pubspec.yaml文件添加依赖配置：

flutter_spinkit: "^2.1.0"

保存后VSCode会自动执行'flutter packages get'下载组件。

使用代码：

final _loadingContainer = Container(
    constraints: BoxConstraints.expand(),
    color: Colors.black12,
    child: Center(
        child: Opacity(
            opacity: 0.9,
            child: SpinKitWave(
              color: Colors.red,
              size: 50.0,
            ),
        ),
    )
);

异步操做

点击按钮后执行的是如下代码：

void _toggleSubmit() {
    if (_formKey.currentState.validate()) {
      setState(() {
        _showLoading = true;
      });

      _loginRequest().then((onValue) {
        setState(() {
          _showLoading = false;
        });
        showDialog(
            context: context,
            builder: (context) {
              String alertText = 'login success!' +
                  ' \nuserName:' +
                  _userNameTextController.text +
                  '\npassWord:' +
                  _passwordTextController.text;
              return AlertDialog(
                content: Text(alertText),
              );
            });
      });
    }
  }

• 显示隐藏加载框

首先经过预先指定的GlobalKey的currentState来拿到对应的FormState, 而后调用validate()方法执行验证Form中的用户名和密码输入内容，经过返回true,不然返回false; 而后经过setState()方法来更新_showLoading属性为true或者false, 便会从新执行build方法，这样就能够动态的显示和隐藏加载框了。

• 异步操做

  Future _loginRequest() async {
    return Future.delayed(Duration(seconds: 3), () {
      //do nothing
      print('login success');
    });
  }

_loginRequest函数返回的是一个Future, 用于dart支持异步操做的关键字，顾名思义这个函数调用后会在将来执行而不是马上执行，更多细节推荐阅读flutter实战5：异步async、await和Future的使用技巧。

在_loginRequest函数中，这里只是简单的执行延迟3秒操做来模拟api调用耗时，点击submit按钮后调用此方法，此方法执行完成后调用then方法使用setState来隐藏加载框，同时弹出提示框显示获取到的用户名和密码。

_loginRequest().then((onValue) {
      setState(() {
        _showLoading = false;
      });
      showDialog(
          context: context,
          builder: (context) {
            String alertText = 'login success!' +
                ' \nuserName:' +
                _userNameTextController.text +
                '\npassWord:' +
                _passwordTextController.text;
            return AlertDialog(
              content: Text(alertText),
            );
          });
    });

嗯，到此就差很少了，该准备下一个学习demo了，后续Demo持续更新...

参考

• Flutter官方文档
• flutter实战5：异步async、await和Future的使用技巧