RxCocoa-Texture

KO | EN

gitlite — search

#python #java #swift #golang #nodejs #android #game #react #machine-learning #tensorflow #javascript #json

RxCocoa-Texture

★ 99 Open GitHub ↗

RxCocoa Extension Library for Texture.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![alt text](https://github.com/RxSwiftCommunity/RxCocoa-Texture/blob/master/resources/logo.png)

[![CI Status](https://api.travis-ci.org/RxSwiftCommunity/RxCocoa-Texture.svg?branch=master)](https://travis-ci.org/GeekTree0101/RxCocoa-Texture)
[![Version](https://img.shields.io/cocoapods/v/RxCocoa-Texture.svg?style=flat)](https://cocoapods.org/pods/RxCocoa-Texture)
[![License](https://img.shields.io/cocoapods/l/RxCocoa-Texture.svg?style=flat)](https://cocoapods.org/pods/RxCocoa-Texture)
[![Platform](https://img.shields.io/cocoapods/p/RxCocoa-Texture.svg?style=flat)](https://cocoapods.org/pods/RxCocoa-Texture)

## Notice
- Now support swift 5.x https://github.com/RxSwiftCommunity/RxCocoa-Texture/blob/swift-5.x
```ruby
pod 'RxCocoa-Texture', '3.x.x'
```

> ### Your Contributions always welcome welcome!.

## Concept
RxCocoa provides extensions to the Cocoa and Cocoa Touch frameworks to take advantage of RxSwift.
Texture provides various basic UI components such as ASTableNode, ASControlNode, ASButtonNode and so on.
ref: [Node Subclasses](http://texturegroup.org/docs/node-overview.html)

So, This Library provides extensions to the Texture frameworks to take advantage of RxSwift like a RxCocoa

ref: [Texture + RxSwift Interactive Wrapper](https://medium.com/@h2s1880/texture-rxswift-interactive-wrapper-d3c9843ed8d7)

## Example

#### Extension

- [ASButtonNode RxExtension Example](https://github.com/GeekTree0101/RxCocoa-Texture/tree/master/Example/RxCocoa-Texture/ButtonTestNode.swift)

- [ASImageNode RxExtension Example](https://github.com/GeekTree0101/RxCocoa-Texture/tree/master/Example/RxCocoa-Texture/ImageTestNode.swift)

- [ASNetworkImageNode RxExtension Example](https://github.com/GeekTree0101/RxCocoa-Texture/tree/master/Example/RxCocoa-Texture/NetworkImageTestNode.swift)

- [ASTextNode RxExtension Example](https://github.com/GeekTree0101/RxCocoa-Texture/tree/master/Example/RxCocoa-Texture/TextTestNode.swift)

- [ASEditableTextNode RxExtension Example](https://github.com/GeekTree0101/RxCocoa-Texture/tree/master/Example/RxCocoa-Texture/EditableTextTestNode.swift)

- [ASScrollNode](https://github.com/ReactiveX/RxSwift/blob/master/RxCocoa/iOS/UIScrollView%2BRx.swift)

#### ASBinder
: Subscribed Observer operates asynchronously.

<table>
  <tr>
    <td align="center">Expectation Flow</td>
    <td align="center">Expectation UI</td>
  </tr>
  <tr>
    <th rowspan="9"><img src="https://github.com/GeekTree0101/RxCocoa-Texture/blob/master/resources/expect.png"></th>
    <th rowspan="9"><img src="https://github.com/GeekTree0101/RxCocoa-Texture/blob/master/resources/expect2.png"></th>
  </tr>
</table>

But, Node dosen't know that event value applied on UI before draw.

<table>
  <tr>
    <td align="center">Unexpectation Flow</td>
    <td align="center">Unexpectation UI</td>
  </tr>
  <tr>
    <th rowspan="9"><img src="https://github.com/GeekTree0101/RxCocoa-Texture/blob/master/resources/badcase.png"></th>
    <th rowspan="9"><img src="https://github.com/GeekTree0101/RxCocoa-Texture/blob/master/resources/badcase2.png"></th>
  </tr>
</table>

In this case, Node should use setNeedsLayout. but, [bind:_] doesn't call setNeedsLayout automatically.

Normally, you can use like this code

```swift
// Profile NetworkImage Node is default
// username, description is Optional

// *** self is usernameNode supernode
viewModel.username
         .subscribe(onNext: { [weak self] text in 
            self?.usernameNode.rx.text(Node.usernameAttributes).onNext(text)
            self?.setNeedsLayout() // Here
         })
         .disposed(by: disposeBag)
```

If you use ASBinder then you don't need call setNeedsLayout. ASBinder will operates it automatically.

```swift
// Profile NetworkImage Node is default
// username, description is Optional

// *** self is usernameNode supernode
viewModel.username
         .bind(to: usernameNode.rx.text(Node.usernameAttributes),
               setNeedsLayout: self) 
         .disposed(by: disposeBag)

// *** self is descriptionNode supernode
viewModel.desc
         .bind(to: descriptionNode.rx.text(Node.descAttributes),
               setNeedsLayout: self) 
         .disposed(by: disposeBag)
```

If you don't need setNeedsLayout then just write code like this.

```swift
// setNeedsLayout default is nil!
viewModel.username
         .bind(to: usernameNode.rx.text(Node.usernameAttributes)) 
         .disposed(by: disposeBag)

viewModel.desc
         .bind(to: descriptionNode.rx.text(Node.descAttributes)) 
         .disposed(by: disposeBag)
```

<table>
  <tr>
    <td align="center">ASBinder Flow</td>
    <td align="center">Output UI</td>
  </tr>
  <tr>
    <th rowspan="9"><img src="https://github.com/GeekTree0101/RxCocoa-Texture/blob/master/resources/asbinder_workflow.png"></th>
    <th rowspan="9"><img src="https://github.com/GeekTree0101/RxCocoa-Texture/blob/master/resources/expect2.png"></th>
  </tr>
</table>

- [ASBinder](https://github.com/GeekTree0101/RxCocoa-Texture/blob/master/Example/RxCocoa-Texture/ASBinderTestNode.swift)

## Installation

RxCocoa-Texture is available through [CocoaPods](https://cocoapods.org). To install
it, simply add the following line to your Podfile:

#### swift 4.x

```ruby
pod 'RxCocoa-Texture'
```

## Caution
This library has been migrated to Texture 2.7.
When Rx subscribe logic moves from initialization to didLoad method. I no longer faced this problem.
When using RxSwift / RxCocoa, it is safe to subscribe from the didLoad method.
https://github.com/TextureGroup/Texture/issues/977

## Author

Geektree0101, h2s1880@gmail.com

## License
This library belongs to RxSwiftCommunity.
RxCocoa-Texture is available under the MIT license. See the LICENSE file for more info

RxCocoa-Texture

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README