「Knockout.js/applyBindings関数」を編集中

[[Knockout.js]]の'''applyBindings関数'''とは、[[Knockout.js]]をアクティブ化する（ビューモデルオブジェクトを関連付ける）もっとも根幹たる関数である。

== 引数 ==
* ko.applyBindings(ビューモデルオブジェクト)
* ko.applyBindings(ビューモデルオブジェクト, DOM要素)

第1引数のみを指定した場合には、全DOM要素（HTML全体）に対してビューモデルオブジェクトが関連付けられる。
<source lang="javascript">
  ko.applyBindings(new AppViewModel());
</source>

第2引数にDOM要素を指定した場合には、そのDOM要素以下にのみビューモデルオブジェクトが関連付けられる。[[HTML]]を領域分けして、それぞれに個別のビューモデルを関連付けたい場合にはこちらを使うとよい。
<source lang="javascript">
  ko.applyBindings(new AppViewModel(), document.getElementById('someElementId'));
</source>
<source lang="javascript">
  ko.applyBindings(new AppViewModel(), jQuery('#someElementId'));
</source>

== 戻り値 ==

== 備考 ==
applyBindings関数を正常に動作させるにはDOMが準備されている必要がある点に注意すること。

HTMLのheadタグ内に書く場合は、素のブラウザ[[JavaScript]]であればonload時、[[jQuery]]であればjQuery関数に指定する[[コールバック関数]]の中で呼び出せば間違いない。
<source lang="html5">
// jQueryでの記述例。
jQuery(function() {
  var AppViewModel = {};
  ko.applyBindings(new AppViewModel());
});
</source>

なお、[[HTML]]のbody閉じタグの直前にscriptタグを書き、その中でapplyBindings関数を呼ぶという手もある。

== 関連項目 ==
* [[Knockout.js]]
** [[Knockout.js/applyBindings関数|applyBindings関数]]
** [[knockout.js/observable関数|observable関数]]（[[knockout.js/observableオブジェクト|observableオブジェクト]]）
** [[knockout.js/computed関数|computed関数]]
** [[knockout.js/observableArray関数|observableArray関数]]（[[knockout.js/observableArrayオブジェクト|observableArrayオブジェクト]]）

== 参考文献 ==
<references/>
== 外部リンク ==

{{stub}}