diff options
| author | Sze Howe Koh <szehowe.koh@gmail.com> | 2014-05-14 22:33:34 +0800 |
|---|---|---|
| committer | The Qt Project <gerrit-noreply@qt-project.org> | 2014-05-16 03:45:07 +0200 |
| commit | ea401b8ebff8ee58f6db7b1c623883a72365a2b8 (patch) | |
| tree | 9156aee24509c117d111ba41c6fa66067ab5ea33 /src/quick/doc | |
| parent | d3064953f12d780e06578d97990533c93b3c2781 (diff) | |
Doc: Describe property bindings in terms of relationships
- This patch aims to help readers think about bindings more
"declaratively" by introducing a new (albeit very leaky) level of
abstraction: Treat bindings as finitary relations, rather than mere
JavaScript expressions.
- In essence, property bindings are for describing relationships between
properties. The fact that the QML engine reactively updates a
property's value when its dependencies change, and the fact that
arbitrarily complex expressions are valid bindings, are simply
implementation details.
- Discourage the use of side effects in property bindings. They are not
essential for the main purpose of property bindings, they break the
finitary relation model, and their use can reduce code
readability/maintainability/toolability.
- Discourage complex property bindings for similar reasons.
Change-Id: I5a0a03bd02768d4c504797a0f86569f3ac066e96
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>
Diffstat (limited to 'src/quick/doc')
| -rw-r--r-- | src/quick/doc/src/concepts/convenience/topic.qdoc | 13 |
1 files changed, 5 insertions, 8 deletions
diff --git a/src/quick/doc/src/concepts/convenience/topic.qdoc b/src/quick/doc/src/concepts/convenience/topic.qdoc index 1a6feeaa61..b87cfd84c1 100644 --- a/src/quick/doc/src/concepts/convenience/topic.qdoc +++ b/src/quick/doc/src/concepts/convenience/topic.qdoc @@ -54,14 +54,11 @@ application performance. \section1 Dynamic Bindings -Assigning binding expressions to properties is a fundamental concept of QML, -and Qt Quick extends upon the idea with the \l Binding type. While bindings -are typically specified as property initialization assignments, the \l Binding -type allows the target of a binding to be defined explicitly and separately -from the definition of the binding expression itself. -By declaring a \l Binding instance, the client can dynamically bind properties -from arbitrary objects at run-time, and can modify the binding target when -required (or when it becomes available). +\l{Property Binding}{Property bindings} are a fundamental feature of QML. +Typically, a property is initialized with its binding. However, the \l Binding +type and \l {Qt::binding()}{Qt.binding()} function allows the client to +dynamically bind properties from any object at run-time, and modify the binding +target when required (or when it becomes available). \section1 Dynamic Signal Connections |