src/main/javadoc/overview.html
changeset 920 117b732d42d0
parent 903 44cb743c3a5b
child 921 7bf1ed2963cb
     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