KnockoutJS 3.X API 第四章表單綁定(10) textInput、hasFocus、checked綁定

textInput綁定目的

textInput綁定主要用于<input>或者<textarea>元素。他提供了DOM和viewmodel的雙向更新。不同于value綁定，textinput綁定是實時更新的。

例如：

Password:

ViewModel:

源碼：

<p>Login name: <input data-bind="textInput: userName" /></p>
<p>Password: <input type="password" data-bind="textInput: userPassword" /></p>
 
ViewModel:
<pre data-bind="text: ko.toJSON($root, null, 2)"></pre>
 
<script>
    ko.applyBindings({
        userName: ko.observable(""),        // Initially blank
        userPassword: ko.observable("abc")  // Prepopulate
    });
</script>

備注1：textInput綁定 VS value綁定

雖然value結合也可以進行雙向文本框和視圖模型性能的結合，但是博主更喜歡textInput，因為他是實時更新的。value綁定與textInput綁定的主要的區別在于：

即時更新

value默認情況下，只有當用戶將焦點從文本框移開后才會更新您的模型。textInput每次擊鍵或其他文本輸入時立刻更新模型。

瀏覽器的事件處理

不同的瀏覽器有著文本輸入機制，如剪切，拖動，或接受自動完成建議的事件在不同的瀏覽器中機制是不一致。value綁定，有額外的選項，如valueUpdate: afterkeydown獲得對特定事件的更新，但是有可能不兼容所有的瀏覽器。

textInput結合是專門用來處理各種瀏覽器的不同機制，即使在應對不同的文字輸入機制也能保持一致和直接更新模型。

不要嘗試使用value和textInput在相同的元素上進行綁定。

hasFocus綁定目的

hasFocus綁定是視圖模型屬性與DOM元素的焦點狀態綁定。它是一個雙向綁定，所以：

如果您的視圖模型屬性設置為true或者false，相關的元素將成為聚焦的或未聚焦。

如果用戶手動對焦或unfocuses相關元件，所述視圖模型屬性將被設置為true或false相應。

如果您正在構建中，編輯元素動態顯示復雜的形式，你想控制，用戶應該開始打字，或插入符的響應位置，這是非常有用的。

示例1

這個例子中當文本框當前具有焦點時則顯示消息，并可以使用一個按鈕通過編程方式觸發焦點。

The textbox has focus

源碼：

<input data-bind="hasFocus: isSelected">
<button data-bind="click: setIsSelected">Focus programmatically</button>
 <span data-bind="visible: isSelected">The textbox has focus</span> 
<script>
var viewModel = {
    isSelected: ko.observable(false),
    setIsSelected: function() { this.isSelected(true) }
};
ko.applyBindings(viewModel,document.getElementById("eq2"));
</script>

示例2

因為hasFocus綁定是雙向綁定，這可以使切換的“編輯”模式更加便捷。

Name:

Click the name to edit it; click elsewhere to apply changes.

源碼：

<p>
    Name: 
    <b data-bind="visible: !editing(), text: name, click: edit">&nbsp;</b>
    <input data-bind="visible: editing, value: name, hasFocus: editing" />
</p>
<p><em>Click the name to edit it; click elsewhere to apply changes.</em></p>
<script>
function PersonViewModel(name) {
    // Data
    this.name = ko.observable(name);
    this.editing = ko.observable(false);
         
    // Behaviors
    this.edit = function() { this.editing(true) }
}
 
ko.applyBindings(new PersonViewModel("Bert Bertington"),document.getElementById("eq3"));

</script>

checked綁定目的

checked綁定主要用于復選框（<input type='checkbox'>）或單選按鈕（<input type='radio'>）并與視圖模型屬性進行綁定。

當用戶更改了表單控件，這將更新您的視圖模型屬性的值。同樣，當您更新您的視圖模型的值，也將直接反映到表單控件上。

注意：對于文本框，下拉列表，以及所有以非可勾選表單控件，需要使用value綁定或者textInput綁定讀寫元素的值，而不是checked綁定。

示例1：復選框綁定

Send me spam:

源碼：

<p>Send me spam: <input type="checkbox" data-bind="checked: wantsSpam" /></p>
 
<script type="text/javascript">
    var viewModel = {
        wantsSpam: ko.observable(true) // Initially checked
    };
 
    // ... then later ...
    viewModel.wantsSpam(false); // The checkbox becomes unchecked
</script>

示例2：多復選框附帶數組綁定

Send me spam:

Preferred flavors of spam:

Cherry

Almond

Monosodium Glutamate

源碼：

<p>Send me spam: <input type="checkbox" data-bind="checked: wantsSpam" /></p>
<div data-bind="visible: wantsSpam">
    Preferred flavors of spam:
    <div><input type="checkbox" value="cherry" data-bind="checked: spamFlavors" /> Cherry</div>
    <div><input type="checkbox" value="almond" data-bind="checked: spamFlavors" /> Almond</div>
    <div><input type="checkbox" value="msg" data-bind="checked: spamFlavors" /> Monosodium Glutamate</div>
</div>
 
<script type="text/javascript">
    var viewModel = {
        wantsSpam: ko.observable(true),
        spamFlavors: ko.observableArray(["cherry","almond"]) // Initially checks the Cherry and Almond checkboxes
    };
 
    // ... then later ...
    viewModel.spamFlavors.push("msg"); // Now additionally checks the Monosodium Glutamate checkbox
</script>

示例3：單選按鈕

Send me spam:

Preferred flavor of spam:

Cherry

Almond

Monosodium Glutamate

源碼：

<p>Send me spam: <input type="checkbox" data-bind="checked: wantsSpam" /></p>
<div data-bind="visible: wantsSpam">
    Preferred flavor of spam:
    <div><input type="radio" name="flavorGroup" value="cherry" data-bind="checked: spamFlavor" /> Cherry</div>
    <div><input type="radio" name="flavorGroup" value="almond" data-bind="checked: spamFlavor" /> Almond</div>
    <div><input type="radio" name="flavorGroup" value="msg" data-bind="checked: spamFlavor" /> Monosodium Glutamate</div>
</div>
 
<script type="text/javascript">
    var viewModel = {
        wantsSpam: ko.observable(true),
        spamFlavor: ko.observable("almond") // Initially selects only the Almond radio button
    };
 
    // ... then later ...
    viewModel.spamFlavor("msg"); // Now only Monosodium Glutamate is checked
</script>

參數

主要技術參數
KO設置元素的選中狀態，以配合您的參數值。任何以前選中的狀態將被覆蓋。您的參數被解釋的方式取決于你綁定元素是什么類型：
- 對于復選框，當參數值true時KO將設置為元素為選中狀態，當它為false則為未選中狀態。如果你給定的不是一個布爾值，KO會松散地解釋。這意味著，非零數字和非null對象和非空字符串都將被解釋為true，而零，null，undefined，和空字符串將被解釋為false。
  當用戶選中或取消選中該復選框，將KO你的模型屬性設置為true或false。
  如果你的參數解析為一個被給予array數組。在這種情況下，KO將設置檢查DOM中value屬性是否與數組值匹配，如果值匹配則被選中，如果不匹配則不勾選。
  當用戶選中或取消選中該復選框，將KO更改對應視圖模型屬性的值。就像示例2一樣。
- 對于單選按鈕，KO將檢查視圖模型的值是否等于單選按鈕DOM節點的value屬性或檢查視圖模型屬性值是否等于checkedValue參數指定的值。就像示例3一樣。
  當選擇了用戶改變其單選按鈕，KO會設置模型屬性值為選定的單選按鈕的值。像示例3中，點擊value="cherry"的單選按鈕后將設置viewModel.spamFlavor為"cherry"。
如果你的參數是監控屬性類型，每當值改變綁定將更新元素的選中狀態。如果該參數是非監控屬性，它只會在首次運行時設置元素的選中狀態，以后再不會更新。
其他參數
- checkedValue
  checkedValue參數定義了使用值與checked綁定結合，而不是元素的value屬性。如果你想要的值是一個字符串（如整數或對象）以外的東西，或者你想動態設置的值，這非常有用。
  例如下邊的例子：
  
  源碼：

<!-- ko foreach: items -->
    <input type="checkbox" data-bind="checkedValue: $data, checked: $root.chosenItems" />
    <span data-bind="text: itemName"></span>
<!-- /ko -->
 
<script type="text/javascript">
    var viewModel = {
        items: ko.observableArray([
            { itemName: 'Choice 1' },
            { itemName: 'Choice 2' }
        ]),
        chosenItems: ko.observableArray()
    };
</script>

如果你的checkedValue參數是一個監控屬性，當值的變化和元素是否被選中，綁定將更新checked模型屬性。對于復選框，它會從數組刪除舊值并添加新的價值。對于單選按鈕，它只會更新模型值。

posted @ 2016-10-11 10:35 SmallProgram 閱讀(3361) 評論(0) 收藏舉報

刷新頁面返回頂部

SmallProgram

Why join the navy if you can be a pirate!

KnockoutJS 3.X API 第四章表單綁定(10) textInput、hasFocus、checked綁定

textInput綁定目的

備注1：textInput綁定 VS value綁定

hasFocus綁定目的

示例1

示例2

checked綁定目的

示例1：復選框綁定

示例2：多復選框附帶數組綁定

示例3：單選按鈕

參數

公告

SmallProgram

Why join the navy if you can be a pirate!

KnockoutJS 3.X API 第四章 表單綁定(10) textInput、hasFocus、checked綁定

textInput綁定目的

備注1：textInput綁定 VS value綁定

hasFocus綁定目的

示例1

示例2

checked綁定目的

示例1：復選框綁定

示例2：多復選框附帶數組綁定

示例3：單選按鈕

參數

公告

KnockoutJS 3.X API 第四章表單綁定(10) textInput、hasFocus、checked綁定