Latest0.4
Homepagehttps://github.com/ReactiveCocoa/ReactiveCocoaLayout
LicenseMIT
Platformsios 6.0, osx 10.7, requires ARC
DependenciesArchimedes, ReactiveCocoa
Authors

ReactiveCocoaLayout is a framework for describing Cocoa and Cocoa Touch layouts
in a reactive way, based on
ReactiveCocoa.

This framework is very much a work in progress at the moment, and should be
considered alpha quality. Breaking changes may happen often during this
time.

Why Not Use Auto Layout?

RCL intends to offer the following advantages over Auto Layout:

  • Explicit and linear layout. Reactive layout proceeds in a linear fashion,
    making it easier to understand and debug the steps it takes along the way.
  • Top-down layout. A view’s layout doesn’t interact with its superview’s
    layout unless the former’s size or frame is explicitly incorporated in the
    latter’s layout chain, creating a unidirectional relationship that leads to
    better encapsulation (no global priorities!) and less complexity.
    Bidirectional relationships are still possible, but must be made explicit.
  • Conditional layouts at runtime. RCL is built on the full power
    of ReactiveCocoa, and signals can
    be composed to dynamically disable and re-enable entire layout chains (like
    when you want to hide and show views) without actually modifying them.
  • Implicit animations. To animate the setting of a view’s frame, simply add
    an animation method into the signal chain. No need to explicitly animate
    constants anywhere.
  • Incremental use. RCL can be used internally in views without any
    implementation details leaking out. Callers using Auto Layout or struts and
    springs can incorporate reactive views without knowing or caring how they
    perform layout internally. No UI-wide slowdowns or behavior changes just from
    using RCL!
  • Extensibility. RCL is made up of many independent bits of functionality
    unified into a framework. It’s easy to extend it with your own functionality
    if you want it to behave differently.
  • Not a black box. Unlike AppKit and UIKit, RCL is an open source project,
    so you can crack open any particular bit and see why it behaves the way it
    does.

Getting Started

To start building the framework, clone this repository and then run script/bootstrap.
This will automatically pull down any dependencies. Then, simply open
ReactiveCocoaLayout.xcworkspace (note: not the .xcodeproj) and build.

To use ReactiveCocoaLayout in your project, you will need to include the ReactiveCocoaLayout.xcodeproj (note: not the .xcworkspace) file in your project, and link
ReactiveCocoa and
Archimedes into your application target.

License

ReactiveCocoaLayout is released under the MIT license. See
LICENSE.md.

Latest podspec

{
    "name": "ReactiveCocoaLayout",
    "version": "0.4",
    "summary": "Reactive layout framework built on top of ReactiveCocoa.",
    "homepage": "https://github.com/ReactiveCocoa/ReactiveCocoaLayout",
    "authors": {
        "ReactiveCocoa": "ReactiveCocoa"
    },
    "source": {
        "git": "https://github.com/ReactiveCocoa/ReactiveCocoaLayout.git",
        "tag": "0.4"
    },
    "license": "MIT",
    "description": "ReactiveCocoaLayout is a framework for describing Cocoa and Cocoa Touch layouts in a reactive way, based on ReactiveCocoa.",
    "requires_arc": true,
    "platforms": {
        "ios": "6.0",
        "osx": "10.7"
    },
    "source_files": "ReactiveCocoaLayout/*.{h,m}",
    "dependencies": {
        "Archimedes": [],
        "ReactiveCocoa": [
            "~> 2.0"
        ]
    },
    "ios": {
        "frameworks": [
            "Foundation",
            "QuartzCore",
            "CoreGraphics",
            "UIKit"
        ],
        "exclude_files": [
            "ReactiveCocoaLayout/NSCell*.{h,m}",
            "ReactiveCocoaLayout/NSControl*.{h,m}",
            "ReactiveCocoaLayout/NSView*.{h,m}"
        ]
    },
    "osx": {
        "frameworks": [
            "Foundation",
            "QuartzCore",
            "ApplicationServices",
            "Cocoa"
        ],
        "exclude_files": "ReactiveCocoaLayout/UIView*.{h,m}"
    },
    "prepare_command": "    find . \( -regex '.*EXT.*\.[mh]$' -o -regex '.*metamacros\.[mh]$' \) -execdir mv {} RAC{} \;n    find . -regex '.*\.[hm]' -exec sed -i '' -E '[email protected]"(EXT.*|metamacros)\.h"@"RAC\1.h"@' {} \;n    find . -regex '.*\.[hm]' -exec sed -i '' -E '[email protected]@@' {} \;n",
    "prefix_header_contents": "#ifdef __OBJC__n#import n#import n#import n#ifdef __IPHONE_OS_VERSION_MIN_REQUIREDn  #import n#elif TARGET_OS_MACn  #import n#endifn#import n#endifnn"
}

Pin It on Pinterest

Share This