Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/RxSwiftCommunity/RxCocoa-Texture

RxCocoa Extension Library for Texture.
https://github.com/RxSwiftCommunity/RxCocoa-Texture

asyncdisplaykit ios-app rxcocoa rxswift texture

Last synced: about 2 months ago
JSON representation

RxCocoa Extension Library for Texture.

Host: GitHub
URL: https://github.com/RxSwiftCommunity/RxCocoa-Texture
Owner: RxSwiftCommunity
License: mit
Created: 2018-08-02T10:30:20.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2021-11-05T16:22:07.000Z (about 3 years ago)
Last Synced: 2024-10-31T16:30:48.188Z (2 months ago)
Topics: asyncdisplaykit, ios-app, rxcocoa, rxswift, texture
Language: Swift
Size: 2.2 MB
Stars: 100
Watchers: 7
Forks: 53
Open Issues: 7
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-rxswift - RxCocoa-Texture

README

        ![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.

  

    Expectation Flow

    Expectation UI

  

  

    

    

  

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

  

    Unexpectation Flow

    Unexpectation UI

  

  

    

    

  

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)

```

  

    ASBinder Flow

    Output UI

  

  

    

    

  

- [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, [email protected]

## License

This library belongs to RxSwiftCommunity.

RxCocoa-Texture is available under the MIT license. See the LICENSE file for more info