Flutter选择时机插件select_when的使用

select_when_context 是一个为 Flutter 提供的扩展包，它通过在 BuildContext 中添加一个 selectWhen 方法来增强 Provider 包的功能。该方法允许你指定条件以控制特定选择器何时被调用，从而帮助你避免不必要的UI更新。

功能

• 条件重建：selectWhen 允许小部件仅在满足特定条件时进行重建，帮助优化性能，减少不必要的更新。
• 改进的控制：通过指定一个 when 断言，你可以控制选择器何时应计算值，防止不必要的重新计算。
• 与 select 相似的API：该扩展基于 Provider 包中的熟悉 select 方法构建，使其易于集成到现有代码库中。

安装

在你的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  select_when_context: ^1.0.0

然后运行：

flutter pub get

使用

selectWhen 扩展为 BuildContext 添加了一个方法，可以更高效地管理小部件的状态。它特别适用于那些依赖于频繁更新值但只在某些条件下需要重建的小部件。

示例

假设你有一个包含 name 和 isLoading 标志的 Person 模型：

class Person with ChangeNotifier {
  String name;
  bool isLoading;

  Person({required this.name, this.isLoading = false});

  // 添加逻辑以更新 `name` 和 `isLoading`
}

你可以在小部件的 build 方法中使用 selectWhen 来仅在 name 发生变化且 isLoading 为 false 时重建它：

import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
import 'package:select_when_context/select_when_context.dart';

class PersonWidget extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    final name = context.selectWhen<String>(
      (person) => person.name,
      when: (person) => !person.isLoading,
    );

    return Text(name);
  }
}

在这个示例中，如果 Person 的 name 发生变化并且 isLoading 为 false，则该小部件将重建。这提供了一种有效的方式来控制小部件何时应该更新，减少不必要的重建。

关键优势

• 性能优化：通过控制选择器函数何时执行，你可以防止过多和不必要的小部件重建。
• 更简单的状态管理：selectWhen 易于使用，类似于标准的 select 方法，但具有通过条件重建添加的灵活性。

API 参考

selectWhen<T, R>

selectWhen 是 BuildContext 上的一个扩展方法：

R selectWhen<T, R>(
  R Function(T value) selector, {
  required bool Function(T value) when,
})

• selector：从类型为 T 的提供者中提取类型为 R 的值的函数。
• when：一个断言函数，根据是否应调用选择器返回 true 或 false。

重要提示

• 仅在 build 方法中使用：selectWhen 应仅在小部件的 build 方法中使用。它不会在其他生命周期方法（如 State.didChangeDependencies）中工作。
• 高效的断言评估：当提供者发出更新时，when 断言会同步评估。如果返回 true，则会调用 selector 并将结果与前一个值比较以确定是否需要重建。

完整示例

考虑以下情景以实现高效的小部件更新：

import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
import 'package:select_when_context/select_when_context.dart';

class Person with ChangeNotifier {
  String name;
  bool isLoading;

  Person({required this.name, this.isLoading = false});

  void updateName(String newName) {
    name = newName;
    notifyListeners();
  }

  void setLoading(bool loading) {
    isLoading = loading;
    notifyListeners();
  }
}

class ExampleWidget extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    final name = context.selectWhen<String>(
      (person) => person.name,
      when: (person) => !person.isLoading,
    );

    return Text(name);
  }
}

void main() {
  runApp(
    ChangeNotifierProvider(
      create: (context) => Person(name: 'John Doe'),
      child: MaterialApp(
        home: Scaffold(
          body: ExampleWidget(),
        ),
      ),
    ),
  );
}