「Knockout.js/valueバインディング」を編集中 (節単位)

== パラメーター ==
valueバインディングの基本的な書式は以下のとおりである。
<source lang="html5">
<input type="text" data-bind="value: ビューモデルのプロパティ名" />
</source>

パラメーター（ビューモデル内のプロパティ）とDOM要素とリンクし、パラメーターが[[Knockout.js/observableオブジェクト|observableオブジェクト]]の場合は、以後[[ビューモデル]]の[[プロパティ]]を更新すれば、ビュー（[[HTML]]）の値も更新され、同様にビュー（HTML）の値が変更されると、ビューモデルのプロパティの値も更新されるようになる。

パラメーターが[[Knockout.js/observableオブジェクト|observableオブジェクト]]でない場合はバインディング適用時（[[Knockout/applyBindings関数|applyBindings関数]]実行時）に1回だけ更新されて以降は更新されない。

=== 追加パラメーター ===
==== valueUpdate ====
valueUpdateパラメーターを設定することで、knockout.jsがイベントを検出するタイミング（ビューの更新を検出するタイミング）を設定することができる。デフォルトではchange（フォーカスが他のコントロールに移ったとき）となっている。

* change - valueUpdateパラメーターを設定しないときのデフォルト値。valueバインディングが設定されているコントロールから別のコントロールへフォーカスが移ったタイミングで更新する。なおselect要素の場合は選択完了ですぐに更新する。
* keyup - キーが離されたタイミングで更新する。
* keypress - キーが押されたタイミングで更新する。ブラウザごとに挙動が違うのでおすすめできない。
* afterkeydown - キーが押された直後に更新する。

基本的には「afterkeydown」→「keypress」→「keyup」の順序でイベントが発生する。ビューの変更をリアルタイムにビューモデルへ反映したい場合には「afterkeydown」がマジオススメ。