1.1 --- a/src/main/javadoc/overview.html Fri Dec 12 11:50:20 2014 +0100
1.2 +++ b/src/main/javadoc/overview.html Fri Dec 19 10:57:23 2014 +0100
1.3 @@ -94,6 +94,27 @@
1.4 {@link org.netbeans.html.json.spi.Transfer Java based JSON} and
1.5 {@link org.netbeans.html.json.spi.WSTransfer WebSocket} implementations
1.6 under the name <b>tyrus</b>.
1.7 + </p>
1.8 + <p>
1.9 + A particular DOM subtree
1.10 + that a <a target="_blank" href="http://knockoutjs.com">knockout.js</a> model gets
1.11 + applied to can be selected by using
1.12 + {@link net.java.html.json.Models#applyBindings(java.lang.Object,%20java.lang.String)
1.13 + Models.applyBindings(m, id)} with an id of an HTML element.
1.14 + There is new {@link net.java.html.json.Model#targetId()} attribute
1.15 + which controls behavior of the generated <code>applyBindings</code> method.
1.16 + If <em>specified and non-empty</em>, then the generated method
1.17 + will call {@link net.java.html.json.Models#applyBindings(java.lang.Object,java.lang.String)}
1.18 + with <code>this</code> and the provided {@link net.java.html.json.Model#targetId() target id}.
1.19 + If <em>specified, but left empty</em>, then the generated method
1.20 + calls {@link net.java.html.json.Models#applyBindings(java.lang.Object)}.
1.21 + <em>If unspecified</em>, the method will <b>not</b> be generated at all
1.22 + (a change with respect to older versions). However one can
1.23 + still use {@link net.java.html.json.Models#applyBindings(java.lang.Object)}
1.24 + or {@link net.java.html.json.Models#applyBindings(java.lang.Object,java.lang.String)}
1.25 + to perform the association of any model with the page element.
1.26 + </ul>
1.27 + <p>
1.28 Memory model when using Knockout bindings has been improved
1.29 (required additions of two new methods:
1.30 {@link org.netbeans.html.json.spi.PropertyBinding#weak()} and