Flutter中的widget

享学课堂特邀作者: 潇湘夜雨

转载请声明出处!

Flutter页面-基础Widget

在Flutter中,几乎所有的对象都是一个 Widget,与原生开发中的控件不同的是,Flutter中的 widget的概念更广泛,它不仅可以表示UI元素,也可以表示一些功能性的组件如:用于手势检测的 GestureDetector widget、用于应用主题数据传递的 Theme等等。由于Flutter主要就是用于构建用户界面的,所以,在大多数时候,可以认为widget就是一个控件,不必纠结于概念。

Widget的功能是“描述一个UI元素的配置数据”,Widget其实并不是表示最终绘制在设备屏幕上的显示元素,而只是显示元素的一个配置数据。实际上,Flutter中真正代表屏幕上显示元素的类是 Element,也就是说Widget只是描述 Element的一个配置。一个Widget可以对应多个 Element,这是因为同一个Widget对象可以被添加到UI树的不同部分,而真正渲染时,UI树的每一个节点都会对应一个 Element对象。

Widget

StatelessWidget和 StatefulWidget是 flutter的基础组件,日常开发中自定义 Widget都是选择继承这两者之一。也是在往后的开放中,我们最多接触的Widget:
StatelessWidget:无状态的,展示信息,面向那些始终不变的UI控件;
StatefulWidget:有状态的,可以通过改变状态使得 UI 发生变化,可以包含用户交互(比如弹出一个 dialog)。

在实际使用中,Stateless与Stateful的选择需要取决于这个 Widget 是有状态还是无状态,简单来说看界面是否需要更新。

StatelessWidget

StatelessWidget用于不需要维护状态的场景,它通常在 build方法中通过嵌套其它Widget来构建UI,在构建过程中会递归的构建其嵌套的Widget。

BuildContext表示构建widget的上下文,它是操作widget在树中位置的一个句柄,它包含了一些查找、遍历当前Widget树的一些方法。每一个widget都有一个自己的context对象。

import 'package:flutter/material.dart';
void main ()=> runApp (StatelessApp());
class StatelessApp extends StatelessWidget {
  //在build方法中通过嵌套其它Widget来构建UI,在构建过程中会递归的构建其嵌套的Widget
  @override
  Widget build(BuildContext context) {
  //嵌套 MaterialApp:封装了应用程序实现Material Design所需要的一些widget
   return MaterialApp(
   title: "Widget演示",
 //标题,显示在recent时候的标题
 //主页面
 //Scaffold : Material Design布局结构的基本实现。
 home: Scaffold(
 //ToolBar/ActionBar
  appBar:AppBar(title: Text("Widget")), 
  body: Text("Hello,Flutter!"),
      )
    );
  }
}

Material Design:

一种设计语言,Material Design 于2014年的 Google I/O
首次亮相,是谷歌推出的全新的设计语言。说白了,就是一种设计风格。

StatefulWidget

StatefulWidget是动态的,添加了一个新的接口 createState()用于创建和Stateful widget相关的状态 State,它在Stateful widget的生命周期中可能会被多次调用。

当State被改变时,可以手动调用其 setState()方法通知Flutter framework状态发生改变,Flutter framework在收到消息后,会重新调用其 build方法重新构建widget树,从而达到更新UI的目的。

class StatefulState extends State<StatefulApp>
 {
  int _i;
///当Widget第一次插入到Widget树时会被调用,对于每一个State对象,Flutter framework只会调用一次该回调
@override
  void initState() {   
  super.initState();
   _i= 1;  
 }
@override
  Widget build (BuildContext context) {
    return MaterialApp (
    title: "Widget演示",
        theme: ThemeData(),
        home:Scaffold (
         appBar: AppBar (title: Text("Widget")),
         body: RaisedButton (
            onPressed: () {              
//修改状态,setState会重新调用build更新ui
        setState(() {_i++;});
          },
         child: Text("Hello,Flutter! $_i"),
          ),
      ));
  }
}

State生命周期

State的生命周期为:
在这里插入图片描述
State类除了 build之外还提供了很多方法能够让我们重写,这些方法会在不同的状态下由Flutter调起执行,所以这些方法我们就称之为生命周期方法。在这里我们用statefulwidget点击按钮后移除子statefulwidget。

import 'package:flutter/material.dart';
void main () => runApp(MyApp());
class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}
class _MyAppState extends State<MyApp> {
  bool isShowChild;  
///当Widget第一次插入到Widget树时会被调用,对于每一个State对象,Flutter framework只会调用一次该回调
  @override
 void initState() {
    super.initState();
    isShowChild = true;
    debugPrint("parent initState......");  
}  
///初始化时,在initState()之后立刻调用  
///当依赖的InheritedWidget rebuild,会触发此接口被调用
  
@override
  void didChangeDependencies() {    
 super.didChangeDependencies();
 debugPrint("parent didChangeDependencies......");  
}
///绘制界面,当setState触发的时候会再次被调用
  
@override
  Widget build(BuildContext context) {
    debugPrint("parent build......");    
    return MaterialApp(
      home: Scaffold(  
        body: Center(
            child: RaisedButton(
              onPressed: () {
            setState(() {
              isShowChild = !isShowChild;            
            });          
          },
          child: isShowChild ? Child() : Text("演示移除Child"),        
       )),      
      ),
    );  
  }

  ///状态改变的时候会调用该方法,比如调用了setState
  
@override
  void didUpdateWidget(MyApp oldWidget) {
    super.didUpdateWidget(oldWidget);
    debugPrint("parent didUpdateWidget......");  
}  
///当State对象从树中被移除时,会调用此回调
  
@override  
void deactivate() {
    super.deactivate();
    debugPrint('parent deactivate......');  
}
  
///当State对象从树中被永久移除时调用;通常在此回调中释放资源
  
@override  
void dispose() {    
  super.dispose();
    debugPrint('parent dispose......');  
  }
}
class Child extends StatefulWidget {
  
  @override
  _ChildState createState() => _ChildState();}
class _ChildState extends State<Child> {
  
@override  
  Widget build(BuildContext context) {
    debugPrint("child build......");    
    return Text('lifeCycle');  
  }
  
@override
  void initState() {    
    super.initState();
    debugPrint("child initState......");  
}  
///初始化时,在initState()之后立刻调用  
///当依赖的InheritedWidget rebuild,会触发此接口被调用
  
@override  
void didChangeDependencies() {    
  super.didChangeDependencies();
    debugPrint("child didChangeDependencies......");  
}
  ///父widget状态改变的时候会调用该方法,比如父节点调用了setState
  
@override
 void didUpdateWidget(Child oldWidget) {
  super.didUpdateWidget(oldWidget);
    debugPrint("child didUpdateWidget......");  
}  
///当State对象从树中被移除时,会调用此回调
  
@override
  void deactivate() {    
    super.deactivate();
    debugPrint('child deactivate......');  
}  
///当State对象从树中被永久移除时调用;通常在此回调中释放资源
  
@override
  void dispose() {    
    super.dispose();
    debugPrint('child dispose......');  
  }
}

执行的输出结果显示为:

  • 运行到显示
I/flutter (22218): parent initState......
I/flutter (22218): parent didChangeDependencies......
I/flutter (22218): parent build......
I/flutter (22218): child initState......
I/flutter (22218): child didChangeDependencies......
I/flutter (22218): child build......
  • 点击按钮会移除Child
I/flutter (22218): parent build......
I/flutter (22218): child deactivate......
I/flutter (22218): child dispose......
  • 将MyApp的代码由 child:isShowChild?Child():Text(“演示移除Child”),改为
    child:Child(),点击按钮时
I/flutter (22765): parent build......
I/flutter (22765): child didUpdateWidget......
I/flutter (22765): child build......

基础widget

文本显示

Text

Text是展示单一格式的文本Widget(Android TextView)。

import 'package:flutter/material.dart';
/// main方法 调用runApp传递Widget,这个Widget成为widget树的根
void main() => runApp(TextApp());
/// 1、单一文本Text
//创建一个无状态的Widget
class TextApp extends
 StatelessWidget { 
  
@override
  Widget build(BuildContext context) {    
//封装了应用程序实现Material Design所需要的一些widget
    return MaterialApp(
      title: "Text演示",
//标题,显示在recent时候的标题      
//主页面      
//Scaffold : Material Design布局结构的基本实现。
     home: Scaffold(        
//ToolBar/ActionBar
     appBar: AppBar(title: Text("Text")),
     body: Text("Hello,Flutter"
     ),      
    ),    
   );  
  }
}

在使用 Text显示文字时候,可能需要对文字设置各种不同的样式,类似Android的 android:textColor/Size等

在Flutter中也拥有类似的属性

Widget _TextBody() {  
  return Text(
    "Hello,Flutter",
    style: TextStyle(        
        //颜色
        color: Colors.red,        
//字号 默认14
      fontSize: 18,        
//粗细
        fontWeight: FontWeight.w800,        
//斜体
        fontStyle: FontStyle.italic,        
//underline:下划线,overline:上划线,lineThrough:删除线
        decoration: TextDecoration.lineThrough,
        decorationColor: Colors.black,        
//solid:实线,double:双线,dotted:点虚线,dashed:横虚线,wavy:波浪线
        decorationStyle: 
      TextDecorationStyle.wavy),  
  );
}
class TextApp extends StatelessWidget {
  
@override 
  Widget
  build(BuildContext context) 
 {    
 return MaterialApp(
   title: "Text演示", 
   home: Scaffold(
     appBar: AppBar(title: Text("Text")),
     body: _TextBody(),      
     ),    
   );  
  }
}

在这里插入图片描述
RichText

如果需要显示更为丰富样式的文本(比如一段文本中文字不同颜色),可以使用 RichText或者 Text.rich

Widget _RichTextBody() {  
  var textSpan = TextSpan(
    text: "Hello",
    style: TextStyle(color: Colors.red),
    children: [
      TextSpan(text: "Flu", style: TextStyle(color: Colors.blue)),
      TextSpan(text: "uter", style: TextStyle(color: Colors.yellow)),
    ],  
);
  //Text.rich(textSpan);
  return RichText(text: textSpan);
}

在这里插入图片描述
DefaultTextStyle
在widget树中,文本的样式默认是可以被继承的,因此,如果在widget树的某一个节点处设置一个默认的文本样式,那么该节点的子树中所有文本都会默认使用这个样式。相当于在Android中定义 Theme

Widget _DefaultStyle(){
  DefaultTextStyle(    
//设置文本默认样式
 style: TextStyle(
   color:Colors.red,
   fontSize: 20.0,    
),
    textAlign: TextAlign.start,
    child: Column(
      crossAxisAlignment: 
      CrossAxisAlignment.start,
      children: <Widget>[        
        Text("Hello Flutter!"),        
        Text("Hello Flutter!"),        
        Text("Hello Flutter!",
             style: TextStyle(
               inherit: false, 
//不继承默认样式
               color: Colors.grey
          ),        
        ),      
      ],    
    ),  
  );
}

FlutterLogo
这个Widget用于显示Flutter的logo…

Widget flutterLogo() {  
  return FlutterLogo(    
//大小
    size: 100,    
//logo颜色 默认为 Colors.blue
    colors: Colors.red,
//markOnly:只显示logo,horizontal:logo右边显示flutter文字,stacked:logo下面显示文字
    style: FlutterLogoStyle.stacked,    
//logo上文字颜色
    textColor: Colors.blue,  
  );
}

在这里插入图片描述
Icon

主要用于显示内置图标的 Widget

Widget icon() {  
  return Icon(      
//使用预定义Material icons      
// https://docs.flutter.io/flutter/material/Icons-class.html
      
Icons.add,
    size: 100,
    color: Colors.red);
}

在这里插入图片描述
Image
显示图片的 Widget。图片常用的格式主要有bmp,jpg,png,gif,webp等,Android中并不是天生支持gif和webp动图,但是这一特性在flutter中被很好的支持了。

在这里插入图片描述
Iamge.asset
在工程目录下创建目录,如:assets,将图片放入此目录。打开项目根目录:pubspec.yaml
在这里插入图片描述

return MaterialApp(
  title: "Image演示",
  home: Scaffold(
    appBar: AppBar(title: Text("Image")),
    body: Image.asset("assets/banner.jpeg"),      
  ),
);

Image.file
在sd卡中放入一张图片。然后利用path_provider库获取sd卡根目录(Dart库版本可以在:https://pub.dartlang.org/packages查询)。
在这里插入图片描述
注意权限

class ImageState extends State<ImageApp> {  
  Image image; 
  
@override
  void initState() {    
   super.initState();
    getExternalStorageDirectory().then((path) {
      setState(() {
        image = Image.file(File("${path.path}${Platform.pathSeparator}banner.jpeg"
      ));
    });
  });  
}
  
@override  
Widget build(BuildContext context) {    
return MaterialApp(
  title: "Image演示",
  home: Scaffold(
    appBar: AppBar(title: Text("Image")),
    body: image,      
    ),    
  );  
 }
}

Image.network

直接给网络地址即可。
Flutter 1.0,加载https时候经常出现证书错误。必须断开AS打开app

Image.memory

Future<List<int>> _imageByte() async {  
  String path = (await getExternalStorageDirectory()).path;  
  return await File("$path${Platform.pathSeparator}banner.jpeg").readAsBytes();
}
class ImageState extends State<ImageApp> {  
  Image image;
  
@override
  void initState() {    
    super.initState();
    _imageByte().then((bytes) { 
      setState(() {
        image = Image.memory(bytes);
      });
    });  
}
  
@override  
Widget build(BuildContext context) { 
  return MaterialApp(
    title: "Image演示",
    home: Scaffold(
      appBar: AppBar(title: Text("Image")),
      body: image,      
    ),
   );
  }
}

CircleAvatar

CircleAvatar(      
    //图片提供者 ImageProvider
      backgroundImage: AssetImage("assets/banner.jpeg"),      
    //半径,控制大小
      radius: 50.0,    
  );

FadeInImage
当使用默认 Image widget显示图片时,您可能会注意到它们在加载完成后会直接显示到屏幕上。这可能会让用户产生视觉突兀。如果最初显示一个占位符,然后在图像加载完显示时淡入,我们可以使用 FadeInImage来达到这个目的!

 image =  FadeInImage.memoryNetwork(
   placeholder: kTransparentImage,
   image: 'https://flutter.io/images/homepage/header-illustration.png',    
);

按钮

Material widget库中提供了多种按钮Widget如RaisedButton、FlatButton、OutlineButton等,它们都是直接或间接对RawMaterialButton的包装定制,所以他们大多数属性都和 RawMaterialButton一样。所有Material 库中的按钮都有如下相同点:

  1. 按下时都会有“水波动画”。
  2. 有一个onPressed属性来设置点击回调,当按钮按下时会执行该回调,如果不提供该回调则按钮会处于禁用状态,禁用状态不响应用户点击。

RaisedButton
"漂浮"按钮,它默认带有阴影和灰色背景

RaisedButton(
  child: Text("normal"),
  onPressed: () => {},        
)

FlatButton

扁平按钮,默认背景透明并不带阴影

FlatButton(
  child: Text("normal"),
  onPressed: () => {},        
)

OutlineButton

默认有一个边框,不带阴影且背景透明。

OutlineButton(
  child: Text("normal"),
  onPressed: () => {},        
)

IconButton

可点击的Icon

IconButton(
  child: Text("normal"),
  onPressed: () => {},        
)

按钮外观可以通过其属性来定义,不同按钮属性大同小异

const FlatButton({
  ...    
@required this.onPressed, 
//按钮点击回调  
this.textColor, 
//按钮文字颜色  
this.disabledTextColor, 
//按钮禁用时的文字颜色  
this.color, 
//按钮背景颜色
this.disabledColor,
//按钮禁用时的背景颜色
this.highlightColor, 
//按钮按下时的背景颜色  
this.splashColor, 
//点击时,水波动画中水波的颜色
this.colorBrightness,
//按钮主题,默认是浅色主题  
this.padding, 
//按钮的填充  
this.shape, 
//外形  
@required this.child, 
//按钮的内容
})
  FlatButton( onPressed: () => {}, 
  child: Text("Raised"),  
//蓝色
  color: Colors.blue,  
//水波
  splashColor: Colors.yellow,  
//深色主题,这样文字颜色会变成白色
  colorBrightness: Brightness.dark,   
//圆角按钮
  shape: RoundedRectangleBorder(
    borderRadius: BorderRadius.circular(50)  
  ),
)

而 RaisedButton,默认配置有阴影,因此在配置 RaisedButton 时,拥有一系列 elevation 属性的配置

const RaisedButton({  
  ...  
  this.elevation = 2.0, 
//正常状态下的阴影 
  this.highlightElevation = 8.0,
//按下时的阴影
  this.disabledElevation = 0.0,
// 禁用时的阴影
  ...
}

输入框

import 'package:flutter/material.dart';
 void main() => runApp(Demo1());
   class Demo1 extends StatelessWidget {
  
@override
    Widget build(BuildContext context) {
    return MaterialApp(
      title: "Demo1",
      home: Scaffold(
        appBar: AppBar(
          title: Text("登录"),        
        ),
      //线性布局,垂直方向
      body: Column(
        children: <Widget>[            
          TextField(              
//自动获得焦点
            autofocus: true,
            decoration: InputDecoration(
              labelText: "用户名",
              hintText: "用户名或邮箱",
              prefixIcon: Icon(Icons.person)),
            ),
          TextField(              
//隐藏正在编辑的文本
             obscureText: true,
              decoration: InputDecoration(
               labelText: "密码",
                hintText: "您的登录密码",
                prefixIcon: Icon(Icons.lock)),
            ),
          ],
        ),      
      ),
    );  
  }
}

在这里插入图片描述
这个效果非常的“系统”,我们可能大多数情况下需要将下划线更换为矩形边框,这时候可能就需要组合widget来完成:

//容器 设置一个控件的尺寸、背景、margin 
Container(
  margin: EdgeInsets.all(32),
    child: TextField(
      keyboardType: TextInputType.emailAddress,
      decoration: InputDecoration(
        labelText: "用户名",
        hintText: "用户名或邮箱",
        prefixIcon: Icon(Icons.person),
            border: InputBorder.none 
//隐藏下划线
)),
//装饰
    decoration: BoxDecoration(      
// 边框浅灰色,宽度1像素
      border: Border.all(color: Colors.red[200], width: 1.0),      
//圆角
      borderRadius: BorderRadius.circular(5.0),
    ),
  )

在这里插入图片描述
焦点控制

FocusNode: 与Widget绑定,代表了这个Widget的焦点

FocusScope: 焦点控制范围

FocusScopeNode:控制焦点

class _TextFocusState extends State<TextFocusWidget> {
  FocusNode focusNode1 = new 
  FocusNode();  FocusNode focusNode2 = new FocusNode();  
void _listener() {
  debugPrint("用户名输入框焦点:${focusNode1.hasFocus}");  
}
  
@override
  void initState() {    
    super.initState();    
//监听焦点状态改变事件
    focusNode1.addListener(_listener);  
}
  
@override
  void dispose() {
    super.dispose();
    focusNode1.dispose();
    focusNode2.dispose();  
}
  
@override
  Widget build(BuildContext context) {
    return Column(
      children: <Widget>[
        TextField(
          autofocus: true,          
//关联焦点
          focusNode: focusNode1,          
//设置键盘动作为: 下一步
          textInputAction: TextInputAction.next,          
//点击下一步执行回调
          onEditingComplete: () {            
//获得 context对应UI树的焦点范围 的焦点控制器
          FocusScopeNode focusScopeNode = FocusScope.of(context);            
//将焦点交给focusNode2
          focusScopeNode.requestFocus(focusNode2);
         },
          decoration: InputDecoration(
          labelText: "用户名",
           hintText: "用户名或邮箱",
         prefixIcon: Icon(Icons.person)),
        ),
        TextField(          
//隐藏正在编辑的文本
        obscureText: true,
          focusNode: focusNode2,
         decoration: InputDecoration(
          labelText: "密码",
           hintText: "您的登录密码",
          refixIcon: Icon(Icons.lock)),
        ),
        custom(),
      ],
    );
  }
}

获取输入内容

获取输入内容有两种方式:

  1. 定义两个变量,用于保存用户名和密码,然后在onChange触发时,各自保存一下输入内容。
  2. 通过controller直接获取。
    onChange获得输入内容:
TextField(
  onChanged: (s) => debugPrint("ssss:$s"),
    

controller获取:

定义一个controller:

//定义一个controller
TextEditingController _unameController=new TextEditingController();

然后设置输入框controller:

TextField(
  controller: _unameController, 
//设置controller
    ...
)

通过controller获取输入框内容

debugPrint(_unameController.text)

TextFormField

TextFormField比 TextField多了一些属性,其中 validator用于设置验证回调。在单独使用时与 TextField没有太大的区别。当结合 From,利用 From可以对输入框进行分组,然后进行一些统一操作(验证)

class _TextFocusState extends State<TextFocusWidget> {  
  //全局key
  GlobalKey<FormState> _key = GlobalKey<FormState>(); 
  
@override  
  Widget build(BuildContext context) {
    return Form(        
//类似 id
      key: _key, 
    child: Column(
 children: <Widget>[            
   TextFormField(
     autofocus: true,
    decoration: InputDecoration(
     labelText: "用户名",
      hintText: "用户名或邮箱",
          icon: Icon(Icons.person)),                
// 校验用户名
      validator: (v) {
        return v.trim().length > 0 ? null : "用户名不能为空";
     }),
   TextFormField(
     decoration: InputDecoration(
      labelText: "密码",     
       hintText: "您的登录密码",
           icon: Icon(Icons.lock)),                
// 校验用户名
      validator: (v) {
        return v.trim().length > 0 ? null : "密码不能为空";
        }),
   RaisedButton(
      onPressed: () {                
//Form所有TextFormField成功 返回true
        if (_key.currentState.validate()) {
          }
      },
     child: Text("提交"),
      )
     ],        
   ));  
  }
}

在这里插入图片描述

喜欢本文的话可以关注我们的官方账号,第一时间获取资讯。
你的关注是对我们更新最大的动力哦~

发布了137 篇原创文章 · 获赞 26 · 访问量 1万+

猜你喜欢

转载自blog.csdn.net/EnjoyEDU/article/details/103380348