Knockout.js 日本語ドキュメント

"enable" バインディング

用途

enable バインディングは、値が true のときだけ関連付けられた DOM エレメントを使用可能にします。 inputselect, textarea などの form 部品でよく使います。

<!-- View -->
<p>
    <input type='checkbox' data-bind="checked: hasCellphone" />
    携帯電話を持っている
</p>
<p>
    電話番号:
    <input type='text' data-bind="value: cellphoneNumber, enable: hasCellphone" />
</p>
// ViewModel
var viewModel = {
    hasCellphone : ko.observable(false),
    cellphoneNumber: ""
};

最初 "電話番号" のテキストボックスは disabled の状態で入力できません。 "携帯電話を持っている" のチェックボックスにチェックを入れたときのみ入力できるようになります。

パラメタ

  • 主パラメタ

    関連付けられた DOM エレメントを使用可能にするか否かを制御するための値です。

    boolean でない値は妥当に解釈されます。 例えば 0nullfalse として扱われ、 21null でないオブジェクトは true として扱われます。

    このパラメタの値が Observable である場合、このバインディングは値が変更される度にエレメントの 使用可 / 使用不可 を更新します。 Observable でない場合は、エレメントの 使用可 / 使用不可 は一度だけ設定され、以降は更新されません。

  • 追加パラメタ

    なし

(注1) 任意の式を使う

変数(プロパティ)への参照だけでなく、エレメントの使用可否を式を使って制御することもできます。

<button data-bind="enable: parseAreaCode(viewModel.cellphoneNumber()) != '555'">
    なにかする
</button>

依存

Knockout コアライブラリ以外、なし。

原文はこちら

side menu