Flutter条件渲染插件conditional_parent_widget的使用

描述

conditional_parent_widget是一个用于根据特定条件有条件地将子树包装在父级组件中的Flutter插件。它允许我们在不破坏代码结构的情况下，灵活地控制某些父级组件的添加与否。

主要参数：

• condition：一个布尔值，决定是否需要将子树child用指定的父级组件包裹。
• child：无论条件如何都会被构建的子树。
• parentBuilder：当condition为真时，用于构建包含子树child的父级组件的构造函数。
• parentBuilderElse（可选）：当condition为假时，用于包裹child的构造函数。如果未提供，则直接返回child。

使用方法

下面给出的是conditional_parent_widget的基本使用示例：

return ConditionalParentWidget(
  condition: shouldIncludeParent, // 根据这个条件判断是否需要添加父级组件
  parentBuilder: (Widget child) => SomeParentWidget(child: child), // 如果条件成立，则使用此构造函数创建父级组件
  child: Widget1(
    child: Widget2(
      child: Widget3(),
    ),
  ), // 这部分是无论如何都会被构建的子组件
);

对比之下，如果不使用该插件，我们通常会这样做：

Widget child = Widget1(
  child: Widget2(
    child: Widget3(),
  ),
);

// 直接使用三元运算符来决定是否需要额外的父级组件
return shouldIncludeParent ? SomeParentWidget(child: child) : child;

这种方式虽然也能实现功能，但在某些场景下可能会导致代码逻辑变得复杂或者难以维护。

完整示例Demo

接下来展示一个完整的例子，其中包含了一个计数器应用，每当计数能够被10整除的时候，就会给文本加上一个蓝色边框作为装饰。

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData.dark(),
      home: MyHomePage(title: 'ConditionalParentWidget Example'),
    );
  }
}

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;

  final boxDecoration = BoxDecoration(
    border: Border.all(
      color: Colors.blueAccent,
    ),
    borderRadius: BorderRadius.all(Radius.circular(5)),
  );

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        // 根据_counter变量的值有条件地添加Container作为父级组件
        child: ConditionalParentWidget(
          condition: _counter % 10 == 0,
          parentBuilder: (child) {
            return Container(
              padding: EdgeInsets.all(10),
              decoration: boxDecoration,
              child: child,
            );
          },
          child: Column(
            mainAxisSize: MainAxisSize.min,
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              Text(
                'You have pushed the button this many times:',
              ),
              Text(
                '$_counter',
                style: Theme.of(context).textTheme.headlineMedium,
              ),
            ],
          ),
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: Icon(Icons.add),
      ),
    );
  }
}

通过上述代码可以看到，在_counter能被10整除时，文本会被放置在一个具有蓝色边框的Container内；而在其他情况下，文本则直接显示出来。这很好地展示了如何利用conditional_parent_widget插件来简化条件渲染的实现。