一統天下 flutter - widget 自定義: 通過組合多個 Widget 的方式實現自定義組件

源碼 https://github.com/webabcd/flutter_demo
作者 webabcd

一統天下 flutter - widget 自定義: 通過組合多個 Widget 的方式實現自定義組件

示例如下:

lib\widget\custom\custom_widget.dart

/*
 * 通過組合多個 Widget 的方式實現自定義組件
 */

import 'dart:math';

import 'package:flutter/material.dart';

import '../../helper.dart';

class CustomWidgetDemo extends StatefulWidget {
  const CustomWidgetDemo({Key? key}) : super(key: key);

  @override
  _CustomWidgetDemoState createState() => _CustomWidgetDemoState();
}

class _CustomWidgetDemoState extends State<CustomWidgetDemo> {

  double _angle = .0;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("title"),),
      backgroundColor: Colors.orange,
      body: Column(
        children: [
          /// 通過繼承已有 Widget 的方式實現自定義 Widget
          const _MyText("_MyText"),

          /// 通過繼承 StatelessWidget 的方式實現自定義的無狀態組件
          _GradientButton(
            colors: const [Colors.red, Colors.green],
            borderRadius: BorderRadius.circular(10),
            width: 300,
            height: 50,
            child: const Text("_GradientButton"),
            onPressed: () {
              setState(() {
                _angle += pi / 2;
              });
            },
          ),

          /// 通過繼承 StatefulWidget 的方式實現自定義的有狀態組件
          _RotationAnimationBox(
            angle: _angle,
            duration: 500,
            child: const MyText("_RotationAnimationBox"),
          ),
        ],
      ),
    );
  }
}

/// 通過繼承已有 Widget 的方式實現自定義 Widget
/// 下面的示例用於實現一個自定義的 Text 組件，其默認文字大小 24，顏色白色，無下劃線
class _MyText extends Text {
  const _MyText(super.data) : super(
    style: const TextStyle(
      fontSize: 24.0,
      color: Colors.white,
      decoration: TextDecoration.none,
    ),
  );
}

/// 通過繼承 StatelessWidget 的方式實現自定義的無狀態組件
/// 下面的示例用於實現一個支持漸變背景色的按鈕組件
class _GradientButton extends StatelessWidget {
  const _GradientButton({
    this.colors,        /// 漸變色
    this.borderRadius,
    this.width,
    this.height,
    required this.onPressed,
    required this.child,
  });
  final List<Color>? colors;
  final BorderRadius? borderRadius;
  final double? width;
  final double? height;
  final GestureTapCallback? onPressed;
  final Widget child;

  @override
  Widget build(BuildContext context) {
    ThemeData theme = Theme.of(context);
    List<Color> _colors = colors ?? [theme.primaryColor];
    return DecoratedBox(
      decoration: BoxDecoration(
        gradient: LinearGradient(colors: _colors),
        borderRadius: borderRadius,
      ),
      child: Material(
        type: MaterialType.transparency,
        child: InkWell(
          borderRadius: borderRadius,
          onTap: onPressed,
          child: ConstrainedBox(
            constraints: BoxConstraints.tightFor(height: height, width: width),
            child: Center(
              child: Padding(
                padding: const EdgeInsets.all(8.0),
                child: DefaultTextStyle(
                  style: const TextStyle(fontWeight: FontWeight.bold),
                  child: child,
                ),
              ),
            ),
          ),
        ),
      ),
    );
  }
}

/// 通過繼承 StatefulWidget 的方式實現自定義的有狀態組件
/// 下面的示例用於實現一個支持旋轉動畫的組件
class _RotationAnimationBox extends StatefulWidget {
  const _RotationAnimationBox({
    this.angle = .0,      /// 目標旋轉弧度
    this.duration = 200,  /// 從當前弧度旋轉到目標旋轉弧度的動畫時長
    required this.child
  });
  final double angle;
  final int duration;
  final Widget child;

  @override
  _RotationAnimationBoxState createState() => _RotationAnimationBoxState();
}
class _RotationAnimationBoxState extends State<_RotationAnimationBox> with SingleTickerProviderStateMixin {
  late AnimationController _controller;

  @override
  void initState() {
    super.initState();
    _controller = AnimationController(vsync: this, lowerBound: -double.infinity, upperBound: double.infinity);
    _controller.value = widget.angle;
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return RotationTransition(
      /// turns 的意思是旋轉的圈數，也就是說 turns = angle / (2 * pi)
      turns: _controller,
      child: widget.child,
    );
  }

  /// 當父組件重繪時
  @override
  void didUpdateWidget(_RotationAnimationBox oldWidget) {
    super.didUpdateWidget(oldWidget);

    /// 如果 _RotationAnimationBox 的 angle 發生變化了則啓動動畫
    if (oldWidget.angle != widget.angle) {
      /// _controller 會從當前值動畫到 widget.angle / (2 * pi)
      _controller.animateTo(widget.angle / (2 * pi), duration: Duration(milliseconds: widget.duration), curve: Curves.ease);
    }
  }
}

源碼 https://github.com/webabcd/flutter_demo
作者 webabcd