view_model 0.5.0-dev.1

view_model: ^0.5.0-dev.1 copied to clipboard

• support ViewModel-to-ViewModel Access

ViewModels can access other ViewModels using readViewModel and watchViewModel:

• readViewModel: Access another ViewModel without reactive connection
• watchViewModel: Create reactive dependency - automatically notifies when the watched ViewModel changes

class UserProfileViewModel extends ViewModel {
  void loadData() {
    // One-time access without listening
    final authVM = readViewModel<AuthViewModel>();
    if (authVM?.isLoggedIn == true) {
      _fetchProfile(authVM!.userId);
    }
  }
  
  void setupReactiveAuth() {
    // Reactive access - auto-updates when auth changes
    final authVM = watchViewModel<AuthViewModel>();
    // This ViewModel will be notified when authVM changes
  }
  
  @override
  void onDependencyNotify(ViewModel viewModel) {
    // Called when watched ViewModels change
    if (viewModel is AuthViewModel) {
      // React to auth changes
      _handleAuthChange(viewModel);
    }
  }
  
  void manualListening() {
    final authVM = readViewModel<AuthViewModel>();
    // You can also manually listen to any ViewModel
    authVM?.listen(() {
      // Custom listener logic
      _handleAuthChange(authVM);
    });
  }
}

Note:

• ViewModel-to-ViewModel watchViewModel does not create listening relationships between ViewModels themselves, but allows the calling ViewModel to react to changes in the watched ViewModel.
• When using watchViewModel, you'll receive onDependencyNotify callbacks when the watched ViewModel changes.
• You can also manually call vm.listen() for custom listening logic.

• The view_model package includes a powerful DevTools extension that provides real-time monitoring and debugging capabilities for your ViewModels during development.

create devtools_options.yaml in root directory of project.

description: This file stores settings for Dart & Flutter DevTools.
documentation: https://docs.flutter.dev/tools/devtools/extensions#configure-extension-enablement-states
extensions:
  - view_model: true

• Breaking change: rename initConfig to initialize

• Add DefaultViewModelFactory for convenient and generic ViewModel factory creation.

• Add ViewModel.maybeRead

• Add maybeWatchViewModel and maybeReadViewModel
• update watchViewModel find logic

VM watchViewModel<VM extends ViewModel>({
  ViewModelFactory<VM>? factory,
  String? key,
  Object? tag,
});

🔍 Lookup Logic Priority (Important) The internal lookup and creation logic of watchViewModel is as follows (executed in priority order):

1. If a key is passed in:

• First, attempt to find an instance with the same key in the cache.
• If a factory exists, use the factory to get a new instance.
• If no factory is found and no instance is found, an error will be thrown.

2. If a tag is passed in, attempt to find the latest created instance which has the same tag in the cache.
3. If nothing passed in, attempt to find the latest created instance of this type in the cache.

⚠️ If no ViewModel instance of the specified type is found, an error will be thrown. Ensure that the ViewModel has been correctly created and registered before use.

• Support find existing ViewModel by tag

set tag in ViewModelFactory.getTag():

class MyViewModelFactory extends ViewModelFactory<MyViewModel> {

  @override
  Object? getTag() {
    return 'tag';
  }
}

find existing ViewModel by tag:

MyViewModel get viewModel => watchViewModel<MyViewModel>(tag: 'tag');

Breaking change:

• Use recycleViewModel instead of refreshViewModel.

Breaking change:

• Use ViewModel instead of StatelessViewModel.

• Use StateViewModel instead of ViewModel.

• Use either watchViewModel or readViewModel instead of getViewModel/ requireExistingViewModel.

• Use StateViewModel.listenState instead of ViewModel.listen.

• Use ViewModel.listen instead of ViewModel.addListener.

• Support ViewModel.read<T> to read existing view model globally.

• transfer to https://github.com/lwj1994/flutter_view_model. thank to Miolin