Flutter签名功能插件sign的使用

Flutter签名功能插件sign的使用

简介

本插件旨在为 Dart 提供基本的状态管理功能。灵感来源于 QT 框架的信号-槽架构。

该插件支持所有包含 Dart SDK 的平台。对于 Flutter 应用程序，可以使用 sign_flutter 插件。

Flutter 包含了一些用于信号的小部件以及从 ChangeNotifier 和 ValueNotifier 生成信号的一些扩展。

什么是信号？

信号是一个在值改变时触发函数的类（或按请求触发）。

在此方面，Signal 类似于 Flutter 的 ChangeNotifier 或 ValueNotifier，GetX 的可观察对象，或者 Provider 的 StateNotifier。

Signal 有一些小差异。首先，它是独立于 Flutter 的，并且非常简单，无需控制大量情况的长代码。

它还使用 Slot 而不是回调。

基本上有三个关键点：

1. Signal：Signal 具有一个 value。当 value 改变或调用 sign() 时，会触发函数。
2. Slot：Slot 可以添加到所需的信号上。当添加到一个信号时，通过 Slot.onValue 处理信号触发。
3. MultiSignal：MultiSignal 既是槽又是信号。它将来自不同信号的触发收集为一个槽并像单个信号一样工作。

如何使用？

1. 定义一个 Signal 实现或从任何变量创建一个 Signal。

/// 从变量创建 Signal
final Signal<int> signal = 0.signal;

void f() {
  signal.value++;
  // 或者
  signal.sign();
}

/// 定义 Signal 实现
class MySignal extends Signal<int> {
  MySignal() : super(0);

  void changeSomething() {
    // 更改信号值以触发信号
    value = newValue;

    // 或使用 sign() 触发信号
    sign();
  }
}

1. 定义一个 Slot 实现。

class MySlot extends Slot<int> {
  MySlot() : super();

  [@override](/user/override)
  void onValue(int value) {
    // 执行某些操作
  }
}

在 Flutter 中，你可以创建本身就是槽的状态。你可以使用 aSignal.builder() 或 SlotWidget。

1. 将 Slot 添加到 Signal。

void f() {
  // 将 Slot 添加到 Signal
  signal.addSlot(MySlot());
}

特殊信号类

如果你想要在列表和映射上触发更改，你不需要使用 value = newList 这样的表达式。这种语句会显著降低性能。

你可以使用 SignalList 和 SignalMap 代替。SignalList 和 SignalMap 在更改集合内容时会触发信号。

final signalList = [].signalList;
final signalMap = {}.signalMap;

void f() {
  signalList.add(1); // 触发

  signalList.remove(1); // 触发

  signalList.clear(); // 触发

  signalList[0] = 10; // 触发
  
  signalMap['a'] = 'b'; // 触发
  
  signalMap.remove('a'); // 触发
}

要创建 SignalList，请使用 SignalList 构造函数或使用 list.signalList 创建。

要创建 SignalMap，请使用 SignalMap 构造函数或使用 map.signalMap 创建。

全局信号/全局槽

GlobalSlot 在相同类型的 GlobalSignal 发生变化时被触发，而无需将其添加到 GlobalSignal 中。

GlobalSignal 必须仅创建一次或在创建新实例之前进行处置。

void main(){
  var globalCounter = GlobalCounter();

  GlobalCountSlot('a');
  GlobalCountSlot('b');
  GlobalCountSlot('c');
  GlobalCountSlot('d');
  GlobalCountSlot('e');
  
  
  globalCounter.value++;
  // GlobalCountSlot 'a', 'b', 'c', 'd', 'e' 触发
}

class GlobalCounter extends GlobalSignal<int> {
  GlobalCounter() : super(0);

  void increment() {
    value++;
  }

  void decrement() {
    value--;
  }
}

class GlobalCountSlot extends GlobalSlot<int, GlobalCounter> {
  GlobalCountSlot(this.name);

  String name;

  [@override](/user/override)
  void onValue(int value) {
    print('GlobalCountSlot :  $name : $value');
  }
}

示例代码

import 'package:sign/sign.dart';

void main() async {
  var slot = CounterSlot();

  var counter = Counter();

  counter.addSlot(slot);

  Stream<int>.periodic(
    Duration(seconds: 1),
    (computationCount) => computationCount,
  ).listen((event) {
    counter.value = event;
  });
}

class CounterSlot extends Slot<int> {
  [@override](/user/override)
  void onValue(int value) {
    print('CounterSlot: $value');
  }
}

class Counter extends Signal<int> {
  Counter() : super(0);

  void increment() {
    value++;
  }

  void decrement() {
    value--;
  }
}