Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/leavez/componentswift
Bring ComponentKit to Swift, A React-inspired view framework for iOS
https://github.com/leavez/componentswift
componentkit ios listview react swift wrapper
Last synced: about 1 month ago
JSON representation
Bring ComponentKit to Swift, A React-inspired view framework for iOS
- Host: GitHub
- URL: https://github.com/leavez/componentswift
- Owner: leavez
- License: mit
- Created: 2017-04-25T17:56:15.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-11-26T02:48:52.000Z (almost 6 years ago)
- Last Synced: 2024-10-04T20:45:52.269Z (about 1 month ago)
- Topics: componentkit, ios, listview, react, swift, wrapper
- Language: Objective-C++
- Homepage:
- Size: 328 KB
- Stars: 49
- Watchers: 4
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](http://cocoapods.org/pods/ComponentSwift)
[](#)
[](https://travis-ci.org/leavez/ComponentSwift)
ComponentSwift brings ComponentKit to swift.
[ComponentKit](http://componentkit.org) is a react-inspired native view framework for iOS developed by Facebook. It intruduces a new abstract layer (component) to automatically handle view reuse, meanwhile providing the ability to build smooth list views easily.
ComponentSwift is an objc wrapper of ComponentKit and refined for swift. ComponentSwift is designed to be a subset of ComponentKit, implementing the most commonly used features.
### Example
```Swift
class CellComponent: CompositeComponent {
init?(text: String) {
super.init(
view:
ViewConfiguration(
attributes:
.backgroundColor(.gray),
.tapGesture(#selector(didTapSelf))
),
component:
getAnotherComponent(text) //
}
// ...
```
or try a real demo with `pod try ComponentSwift`
## Supported Features
#### Supported:
- [x] Component:
- almost all built-in components.
- ability to wrap an existing CKComponent on your own
- [x] Datasource:
- CollectionViewTransactionalDatasource
- TableViewTransactionalDatasource (unofficial)
- HostingView
- [x] Response Chain and Actions
- [x] Scope and State
- [x] Animation
#### Not supported:
- [ ] component controller and StatefulViewComponent
- [ ] things about viewContext, mount
- [ ] `computeLayoutThatFits:` overriding
- [ ] ...
### Working with legacy code
Legacy CKComponent classes could continue to work in swift when using ComponentSwift. Classes and methods are provided to wrap your legacy components conveniently. Every attribute in ComponentKit has an equivalent in ComponentSwift.
Subclass `CSCompositeComponent` and use `initWithCKComponent` in its implementation. Import `ComponentSubclass.h` to use this stuff. Reference more from `WrapExisted` in the demo project.
[more document here](/etc/doc.md)
## TLDR
ComponentKit is implemented and used with objc++, which is pretty cool. It's incompatible with swift, since swift doesn't support objc++. So that's the reason for ComponentSwift.
A objc wrapper is implemented to bridge componentKit to swift. It creates an objc version equivalent for every type in componentKit's APIs, objc class for c++ struct/class, hiding the c++ header in the implementation. It doesn't touch deep in componentKit. The runtime code is almost the same to the one using componentKit directly in the simplest situation except for construction of objc layer, so it's safe to use.
It refined the bridged interface for swift, including notating nullability, adding default parameter and swift-only api. C++'s aggregate initialization is very expressive in componentKit. ComponentSwift tries hard to simulate the api with default parameters and ExpressibleByXXXLiteral. At least we got code completion here.
## Installation
```ruby
pod "ComponentSwift"
```
Swift version:
- swift 4.2: v0.5
- swift 4.1: v0.4.1
- swift 3: v0.3
## License
ComponentSwift is available under the MIT license.