https://github.com/tiagolr/simplebinds

Haxe library that enable events when variable values change.
https://github.com/tiagolr/simplebinds

Last synced: about 2 months ago
JSON representation

Haxe library that enable events when variable values change.

• Host: GitHub
• URL: https://github.com/tiagolr/simplebinds
• Owner: tiagolr
• Created: 2015-03-10T19:17:36.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2015-03-11T18:02:10.000Z (almost 10 years ago)
• Last Synced: 2023-03-27T08:50:26.008Z (almost 2 years ago)
• Language: Haxe
• Size: 141 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
##Example

```haxe

@:build(simple.bind.Macros.build())

class MyClass {

	@bind public var someVar:Int = 0;

}

class OtherClass {

	public function new() {

		var instance = new MyClass();

		simple.bind.Dispatcher.addListener(instance, "someVar", onVarChanged);

		instance.someVar = 100;

	}

	

	function onVarChanged(signal:{}) {

		trace(Std.is(signal.sender, MyClass));

		trace('${signal.field} changed from: ${signal.from} to ${signal.to});

	}

}

```

outputs:


```

true

someVar changed from 0 to 100

```

###Whats it useful for?

For example to update ui components or visualizers when data changes, it's the main reason why this library was made.

###How it works?

```@build(simple.bind.Macros.build())``` and ```@bind``` metadata are used to add a call to ```Dispatcher.dispatch()``` when the field changes, the call is added before the end of a variable setter, if the variable has no setter it creates a new one.

###Aren't there other binding libraries?

There are, and this one is based of **bindx**, the difference is that it only implements the basic method to dispatch events from a static dispatcher, it does not implement two-way binding or force you to implement extra setters or calls.

###Wait, where is the two-way binding in this?

There isn't, however it provides a base where the two way binding can be created by listening to the dispatcher events like the high-tech example above.

###Tested targets:

- js

- cpp

- neko

- flash

###Todo:

* See if its feasable to bind a parent class field, this would be very useful for example to listen to a openfl ```DisplayObject``` children ```x``` or ```y``` changes.