You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Documentation/FrameworkOverview.md
+10-3Lines changed: 10 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -136,15 +136,15 @@ For interaction with `NSControl` or `UIControl`, RAC provides the
136
136
137
137
## Properties
138
138
139
-
A **property**, represented by the [`PropertyType`][Property] protocol,
139
+
A **property**, represented by the [`PropertyProtocol`][Property],
140
140
stores a value and notifies observers about future changes to that value.
141
141
142
142
The current value of a property can be obtained from the `value` getter. The
143
143
`producer` getter returns a [signal producer](#signal-producers) that will send
144
-
the property’s current value, followed by all changes over time.
144
+
the property’s current value, followed by all changes over time. The `signal` getter returns a [signal](#signals) that will send all changes over time, but not the initial value.
145
145
146
146
The `<~` operator can be used to bind properties in different ways. Note that in
147
-
all cases, the target has to be a [`MutablePropertyType`][Property].
147
+
all cases, the target has to be a [`BindingTarget`][BindingTarget], [`MutableProperty`][MutableProperty] is the only property that implements this.
148
148
149
149
*`property <~ signal` binds a [signal](#signals) to the property, updating the
150
150
property’s value to the latest value sent by the signal.
@@ -157,9 +157,14 @@ The [`DynamicProperty`][Property] type can be used to bridge to Objective-C APIs
157
157
that require Key-Value Coding (KVC) or Key-Value Observing (KVO), like
158
158
`NSOperation`. Note that most AppKit and UIKit properties do _not_ support KVO,
159
159
so their changes should be observed through other mechanisms.
160
+
161
+
[ReactiveCocoa][ReactiveCocoa] implements a number of extensions on AppKit and UIKit to allow observation of and binding to properties via the `.reactive` structure.
162
+
160
163
[`MutableProperty`][Property] should be preferred over dynamic properties
161
164
whenever possible!
162
165
166
+
Properties provide a number of transformations like `map`, `combineLatest` or `zip` for manipulation similar to [signal](#signals) and [signal producer](#signal-producers)
167
+
163
168
## Disposables
164
169
165
170
A **disposable**, represented by the [`Disposable`][Disposable] protocol, is a mechanism
@@ -199,6 +204,7 @@ do not allow tasks to be reordered or depend on one another.
0 commit comments