欢迎访问 生活随笔!

生活随笔

当前位置: 首页 > 编程资源 > 编程问答 >内容正文

编程问答

【Flutter】自定义 Flutter 组件 ( 创建自定义 StatelessWidget、StatefulWidget 组件 | 调用自定义组件 )

发布时间:2025/6/17 编程问答 50 豆豆
生活随笔 收集整理的这篇文章主要介绍了 【Flutter】自定义 Flutter 组件 ( 创建自定义 StatelessWidget、StatefulWidget 组件 | 调用自定义组件 ) 小编觉得挺不错的,现在分享给大家,帮大家做个参考.

文章目录

  • 一、Flutter 组件简介
  • 二、Flutter 自定义 StatelessWidget 组件流程
    • 1、导入父类包
    • 2、选择继承的父类
    • 3、设置成员变量及构造函数
    • 4、重写 build 方法
    • 5、完整代码示例
  • 三、Flutter 自定义 StatefulWidget 组件流程
  • 四、使用 final 修饰 Widget 组件成员变量分析
  • 五、调用自定义组件
    • 1、主要方法
    • 2、完整代码
    • 3、效果展示
  • 六、博客资源





一、Flutter 组件简介



Flutter 开发中 , 组件可以是一个 Button 按钮 , Text 文本 , 也可以是封装好的一大块区域 ; 组件由 Widget 组成 ;





二、Flutter 自定义 StatelessWidget 组件流程




1、导入父类包


自定义组件需要继承 StatefulWidget 或 StatelessWidget , 这两个父类组件都在 material.dart 中 , 因此这里先把依赖导入 ;

import 'package:flutter/material.dart';

2、选择继承的父类


自定义组件继承 StatefulWidget 还是 StatelessWidget , 继承哪个组件 , 由组件的性质决定 ;

  • 如果 组件 只是纯展示 , 没有交互操作 , 那么继承 StatelessWidget ;
  • 如果 组件 需要根据交互内容 , 动态修改内容 , 那么继承 StatefulWidget ;

3、设置成员变量及构造函数


声明组件的成员变量 , 注意成员变量使用 final 修饰 ;

/// 组件属性必须使用 final 修饰/// 所有的 Widget 组件都是不可变的final String name;final int? age;/// Dart 构造函数中 , {} 内的是可选参数 , 可选参数必须在参数的最后/// 这里注意 , 可选参数如果定义为非空类型 , 那么必须有一个默认值/// 可选参数如果定义为可空类型 , 可以不用进行初始化const StudentStatelessWidget({this.name = "Tom", this.age});

4、重写 build 方法


StatelessWidget 中的 build 方法是抽象方法 , 必须实现 Widget build(BuildContext context) 方法 ;

abstract class StatelessWidget extends Widget {const StatelessWidget({ Key? key }) : super(key: key);@overrideStatelessElement createElement() => StatelessElement(this);@protectedWidget build(BuildContext context); }

继承 StatefulWidget 或 StatelessWidget 后 , 需要重写其 build 构造方法 ,

在该构造方法中 , 自定义组件行为 , 在这里拼装组件即可 ;

@overrideWidget build(BuildContext context) {return Text("$name : $age");}

5、完整代码示例


import 'package:flutter/material.dart';/// 自定义组件继承 StatefulWidget 还是 StatelessWidget /// 由组件的性质决定 /// 如果 组件 只是纯展示 , 没有交互操作 , 那么继承 StatelessWidget /// 如果 组件 需要根据交互内容 , 动态修改内容 , 那么继承 StatefulWidget /// StatelessWidget 和 StatefulWidget 都需要导入如下包 /// import 'package:flutter/material.dart'; class StudentStatelessWidget extends StatelessWidget{/// 组件属性必须使用 final 修饰/// 所有的 Widget 组件都是不可变的final String name;final int? age;/// Dart 构造函数中 , {} 内的是可选参数 , 可选参数必须在参数的最后/// 这里注意 , 可选参数如果定义为非空类型 , 那么必须有一个默认值/// 可选参数如果定义为可空类型 , 可以不用进行初始化const StudentStatelessWidget({this.name = "Tom", this.age});@overrideWidget build(BuildContext context) {return Text("$name : $age");} }



三、Flutter 自定义 StatefulWidget 组件流程



自定义 StatefulWidget 组件 , 导入的包 定义 final 成员变量 与 StatelessWidget 组件相同 ;

StatefulWidget 中 State createState() 方法是抽象的 ;

因此 , StatefulWidget 组件不再实现 Widget build(BuildContext context) 方法 , 而是实现 State createState() 方法 ;

abstract class StatefulWidget extends Widget {const StatefulWidget({ Key? key }) : super(key: key);@overrideStatefulElement createElement() => StatefulElement(this);@protected@factoryState createState(); // ignore: no_logic_in_create_state, this is the original sin }

State<StatefulWidget> createState() 方法返回值类型 State 需要设置一个泛型 , 说明该 State 是用于哪个 StatefulWidget 组件的 ; 该泛型必须是 StatefulWidget 的子类 ;

@optionalTypeArgs abstract class State<T extends StatefulWidget> with Diagnosticable {@protectedWidget build(BuildContext context); }

自定义 State 类必须实现 Widget build(BuildContext context) 抽象方法 ;


实现的 StatefulWidget 的 createState 方法返回值 , 一般需要自定义 State<StatefulWidget> 实现类 ;

State<StatefulWidget> createState()

在该 State<StatefulWidget> 实现类中 , 实现 build 方法 , 返回要显示的组件 ;

/// 该类用于管理组件中的状态 /// 需要继承 createState 方法返回值类型 State<StatefulWidget> /// 在该类中 , 调用 setState 方法 , 可以更新组件 class _StudentStatefulWidgetState extends State<StatefulWidget> {/// 成员变量String name;int age;/// 构造函数_StudentStatefulWidgetState(this.name, this.age);@overrideWidget build(BuildContext context) {return Text("$name : $age");} }

完整代码示例 :

import 'package:flutter/material.dart';/// 自定义组件继承 StatefulWidget 还是 StatelessWidget /// 由组件的性质决定 /// 如果 组件 只是纯展示 , 没有交互操作 , 那么继承 StatelessWidget /// 如果 组件 需要根据交互内容 , 动态修改内容 , 那么继承 StatefulWidget /// StatelessWidget 和 StatefulWidget 都需要导入如下包 /// import 'package:flutter/material.dart'; class StudentStatefulWidget extends StatefulWidget{/// 组件属性必须使用 final 修饰/// 所有的 Widget 组件都是不可变的final String name;final int? age;/// Dart 构造函数中 , {} 内的是可选参数 , 可选参数必须在参数的最后/// 这里注意 , 可选参数如果定义为非空类型 , 那么必须有一个默认值/// 可选参数如果定义为可空类型 , 可以不用进行初始化const StudentStatefulWidget({this.name = "Tom", this.age});@overrideState<StatefulWidget> createState() => _StudentStatefulWidgetState(name, age!); }/// 该类用于管理组件中的状态 /// 需要继承 createState 方法返回值类型 State<StatefulWidget> /// 在该类中 , 调用 setState 方法 , 可以更新组件 class _StudentStatefulWidgetState extends State<StatefulWidget> {/// 成员变量String name;int age;/// 构造函数_StudentStatefulWidgetState(this.name, this.age);@overrideWidget build(BuildContext context) {return Text("$name : $age");} }



四、使用 final 修饰 Widget 组件成员变量分析



组件属性必须使用 final 修饰 , 如果不使用 final 修饰组件属性 , 会有如下报错 ;

Can't define a const constructor for a class with non-final fields. (Documentation) Try making all of the fields final, or removing the keyword 'const' from the constructor.


我们自定义的 StudentWidget 继承了 StatelessWidget 类 , StatelessWidget 继承了 Widget ;

abstract class StatelessWidget extends Widget { }

Widget 类由 @immutable 注解修饰 , 被该注解修饰的类 , 该类以及其子类中 的 成员变量都是不可变的 , 即都要被 final 类型修饰 ;

@immutable abstract class Widget extends DiagnosticableTree { }



五、调用自定义组件




1、主要方法


在 main.dart 中 , 使用如下代码 , 创建组件 ;

StudentStatelessWidget(name: "Tom",age: 18 ), StudentStatefulWidget(name: "Jerry",age: 16 ),

2、完整代码


完整代码 :

import 'package:flutter/material.dart'; import 'package:flutter_widget/widget/student_stateful_widget.dart'; import 'package:flutter_widget/widget/student_stateless_widget.dart';void main() {runApp(MyApp()); }class MyApp extends StatelessWidget {@overrideWidget build(BuildContext context) {return MaterialApp(title: 'Flutter Demo',theme: ThemeData(primarySwatch: Colors.blue,),home: MyHomePage(title: 'Flutter Demo Home Page'),);} }class MyHomePage extends StatefulWidget {MyHomePage({Key? key, required this.title}) : super(key: key);final String title;@override_MyHomePageState createState() => _MyHomePageState(); }class _MyHomePageState extends State<MyHomePage> {int _counter = 0;void _incrementCounter() {setState(() {_counter++;});}@overrideWidget build(BuildContext context) {return Scaffold(appBar: AppBar(title: Text(widget.title),),body: Center(child: Column(mainAxisAlignment: MainAxisAlignment.center,children: <Widget>[StudentStatelessWidget(name: "Tom",age: 18),StudentStatefulWidget(name: "Jerry",age: 16),Text('You have pushed the button this many times:',),Text('$_counter',style: Theme.of(context).textTheme.headline4,),],),),floatingActionButton: FloatingActionButton(onPressed: _incrementCounter,tooltip: 'Increment',child: Icon(Icons.add),), // This trailing comma makes auto-formatting nicer for build methods.);} }

3、效果展示


效果展示 : 红色矩形框中是显示的两个组件 ;





六、博客资源



GitHub : https://github.com/han1202012/flutter_widget

总结

以上是生活随笔为你收集整理的【Flutter】自定义 Flutter 组件 ( 创建自定义 StatelessWidget、StatefulWidget 组件 | 调用自定义组件 )的全部内容,希望文章能够帮你解决所遇到的问题。

如果觉得生活随笔网站内容还不错,欢迎将生活随笔推荐给好友。