# flutter-mvvm

**Repository Path**: rohity/flutter-mvvm

## Basic Information

- **Project Name**: flutter-mvvm
- **Description**: 一个 Flutter 的 MVVM(Model-View-ViewModel) 实现， 它使用基于属性 (property) 的数据绑定在视图模型 (ViewModel) 与视图 
- **Primary Language**: Dart
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://www.oschina.net/p/flutter-mvvm
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2020-12-28
- **Last Updated**: 2021-06-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


[![pub package](https://img.shields.io/pub/v/mvvm.svg)](https://pub.dev/packages/mvvm)
[![join chat](https://badges.gitter.im/unicreators/mvvm.svg)](https://gitter.im/unicreators/mvvm)



A Flutter MVVM (Model-View-ViewModel) implementation. It uses property-based data binding to establish a connection between the ViewModel and the View, and drives the View changes through the ViewModel.
  
  

一个 Flutter 的 MVVM(Model-View-ViewModel) 实现。 它使用基于属性 (property) 的数据绑定在视图模型 (ViewModel) 与视图 (View) 之间建立关联，并通过视图模型 (ViewModel) 驱动视图 (View) 变化。 
  
##   

[Documentation](https://pub.dev/documentation/mvvm/latest/mvvm/mvvm-library.html)  & [Example](./example/lib/main.dart) 


 
```dart
import 'package:flutter/widgets.dart';
import 'package:mvvm/mvvm.dart';
import 'dart:async';

// ViewModel
class Demo1ViewModel extends ViewModel {
  Demo1ViewModel() {
    propertyValue<String>(#time, initial: "");
    start();
  }

  start() {
    Timer.periodic(const Duration(seconds: 1), (_) {
      var now = DateTime.now();
      setValue<String>(#time, "${now.hour}:${now.minute}:${now.second}");
    });
  }
}

// View
class Demo1View extends View<Demo1ViewModel> {
  Demo1View() : super(Demo1ViewModel());

  @override
  Widget build(BuildContext context) {
    return Container(
        margin: EdgeInsets.symmetric(vertical: 100),
        padding: EdgeInsets.all(40),
        // binding
        child: $.watchFor<String>(#time,
            builder:
                $.builder1((t) => Text(t, textDirection: TextDirection.ltr))));
  }
}

// run
void main() => runApp(Demo1View());

```


![mvvm](./img.png)


## APIs

### ViewContext ($.*)

#### Properties

* [model](./APIs.md#viewcontextmodel)

#### Methods

* [watch](./APIs.md#watch)
* [watchFor](./APIs.md#watchfor)
* [watchAny](./APIs.md#watchany)
* [watchAnyFor](./APIs.md#watchanyfor)
* [$cond](./APIs.md#cond)
* [$condFor](./APIs.md#condfor)
* [$if](./APIs.md#if)
* [$ifFor](./APIs.md#iffor)
* [$switch](./APIs.md#switch)
* [$switchFor](./APIs.md#switchfor)
* [adapt](./APIs.md#adapt)
* [builder0](./APIs.md#builder0)
* [builder1](./APIs.md#builder1)
* [builder2](./APIs.md#builder2)

*override*

* [viewInit](./APIs.md#viewcontextviewinit)
* [viewReady](./APIs.md#viewcontextviewready)
* [dispose](./APIs.md#viewcontextdispose)

### ViewModel

#### Methods

* [registryProperty](./APIs.md#registryproperty)
* [propertyValue](./APIs.md#propertyvalue)
* [propertyAdaptive](./APIs.md#propertyadaptive)
* [propertyAsync](./APIs.md#propertyasync)
* [getValue](./APIs.md#getvalue)
* [setValue](./APIs.md#setvalue)
* [updateValue](./APIs.md#updatevalue)
* [notify](./APIs.md#notify)

*override*

* [viewInit](./APIs.md#viewmodelviewinit)
* [viewReady](./APIs.md#viewmodelviewready)
* [dispose](./APIs.md#viewmodeldispose)


### View

#### Properties

* [$](./APIs.md#viewviewcontext)
* [$Model](./APIs.md#model)

#### Methods

* [setState](./APIs.md#setstate)

*override*

* [init](./APIs.md#init)
* [ready](./APIs.md#ready)
* [dispose](./APIs.md#viewdispose)



[Documentation](https://pub.dev/documentation/mvvm/latest/mvvm/mvvm-library.html)



## License

[MIT](LICENSE)