data-bind綁定語法

Knockout的聲明性綁定系統提供了一種簡潔而強大的方法來將數據鏈接到UI。 綁定到簡單的數據屬性或使用單個綁定通常是容易和明顯的。 對于更復雜的綁定，它有助于更好地了解Knockout的綁定系統的行為和語法。

綁定語法

綁定包含兩個項目，綁定名稱和值，用冒號分隔。 這里是一個單一的簡單綁定的示例：

Today's message is: <span data-bind="text: myMessage"></span>

元素可以包括多個綁定（相關或不相關），每個綁定由逗號分隔。 這里有些例子：

<!-- related bindings: valueUpdate is a parameter for value -->
Your value: <input data-bind="value: someValue, valueUpdate: 'afterkeydown'" />
 
<!-- unrelated bindings -->
Cellphone: <input data-bind="value: cellphoneNumber, enable: hasCellphone" />

綁定名稱通常應與注冊的綁定處理程序（內置或自定義）匹配，或者是另一綁定的參數。 如果名稱不匹配，Knockout將忽略它（沒有任何錯誤或警告）。 因此，如果綁定看起來不工作，首先檢查名稱是否正確。

綁定值

綁定值可以是單個值，變量或字面值或幾乎任何有效的JavaScript表達式。 下面是各種綁定值的示例：

<!-- variable (usually a property of the current view model -->
<div data-bind="visible: shouldShowMessage">...</div>
 
<!-- comparison and conditional -->
The item is <span data-bind="text: price() > 50 ? 'expensive' : 'cheap'"></span>.
 
<!-- function call and comparison -->
<button data-bind="enable: parseAreaCode(cellphoneNumber()) != '555'">...</button>
 
<!-- function expression -->
<div data-bind="click: function (data) { myFunction('param1', data) }">...</div>
 
<!-- object literal (with unquoted and quoted property names) -->
<div data-bind="with: {emotion: 'happy', 'facial-expression': 'smile'}">...</div>

這些示例顯示該值可以只是關于任何JavaScript表達式。 即使逗號和括號括在大括號，括號或括號中。 當值是對象字面值時，對象的屬性名稱必須是有效的JavaScript標識符或用引號括起來。 如果綁定值是無效表達式或引用未知變量，Knockout將輸出錯誤并停止處理綁定。

帶空格的綁定寫法

綁定可以包含任意數量的空格（空格，制表符和換行符），因此您可以隨意使用它來根據需要排列綁定。 以下示例均等效：

<!-- no spaces -->
<select data-bind="options:availableCountries,optionsText:'countryName',value:selectedCountry,optionsCaption:'Choose...'"></select>
 
<!-- some spaces -->
<select data-bind="options : availableCountries, optionsText : 'countryName', value : selectedCountry, optionsCaption : 'Choose...'"></select>
 
<!-- spaces and newlines -->
<select data-bind="
    options: availableCountries,
    optionsText: 'countryName',
    value: selectedCountry,
    optionsCaption: 'Choose...'"></select>

無值綁定

從Knockout 3.0開始，您可以指定沒有值的綁定，這將給綁定一個未定義的值。 例如：

<span data-bind="text">Text that will be cleared when bindings are applied.</span>

當與綁定預處理配合使用時，此功能特別有用，可以為綁定分配默認值。

綁定上下文

綁定上下文是保存您可以從綁定引用的數據的對象。 在應用綁定時，Knockout自動創建和管理綁定上下文的層次結構。 層次結構的根級別是指您提供給ko.applyBindings（viewModel）的viewModel參數。 然后，每次使用控制流綁定（如with或foreach）時，都會創建引用嵌套視圖模型數據的子綁定上下文。

綁定上下文提供以下特殊屬性，您可以在任何綁定中引用：

• $parent

  這是父上下文中的視圖模型對象，即緊接在當前上下文之外的視圖模型對象。 在根上下文中，這是未定義的。 例：

  <h1 data-bind="text: name"></h1>
  
  <div data-bind="with: manager">
  
  <!-- Now we're inside a nested binding context -->
  
  <span data-bind="text: name"></span> is the
  
  manager of <span data-bind="text: $parent.name"></span>
  
  </div>

• $parents

  這是一個表示所有父視圖模型的數組：

  $ parents [0]是來自父上下文的視圖模型（即，它與$ parent相同）

  $ parents [1]是祖父上下文的視圖模型

  $ parents [2]是祖父的祖父母上下文的視圖模型

  … and so on.

• $root

  這是根上下文中的主視圖模型對象，即最頂層父上下文。 它通常是傳遞給ko.applyBindings的對象。 它等價于$ parents [$ parents.length - 1]。

• $component(未來章節詳細介紹)

  如果你在特定組件模板的上下文中，那么$ component引用該組件的viewmodel。 它是特定于組件的等價于$ root。 在嵌套組件的情況下，$ component指的是最近組件的viewmodel。

  這是有用的，例如，如果組件的模板包含一個或多個foreach塊，其中您希望引用組件視圖模型上的某些屬性或函數，而不是當前數據項。

• $data

  這是當前上下文中的視圖模型對象。 在根上下文中，$ data和$ root是等效的。 在嵌套綁定上下文中，此參數將設置為當前數據項（例如，在with：person綁定內，$ data將設置為person）。 $ data在你想引用viewmodel本身時很有用，而不是viewmodel上的一個屬性。 例：

  <ul data-bind="foreach: ['cats', 'dogs', 'fish']">
  
  <li>The value is <span data-bind="text: $data"></span></li>
  
  </ul>

• $index (僅在foreach綁定中可用)

  這是由foreach綁定呈現的當前數組條目的從零開始的索引。 與其他綁定上下文屬性不同，$ index是一個observable，并且只要項目的索引發生更改（例如，如果項目添加到數組或從數組中刪除），就會更新。

• $parentContext

  這指的是父級別的綁定上下文對象。 這與$ parent不同，$ parent指的是父級別的數據（非綁定上下文）。 例如，如果您需要從內部上下文（用法：$ parentContext。$ index）訪問外部foreach項的索引值，這是有用的。 在根上下文中未定義。

• $rawData

  這是當前上下文中的原始視圖模型值。 通常這將與$ data相同，但是如果提供給Knockout的視圖模型包裝在一個observable中，那么$ data將是展開的視圖模型，$ rawData將是observable本身。

• $componentTemplateNodes

  如果你在特定組件模板的上下文中，那么$ componentTemplateNodes是一個包含傳遞給該組件的任何DOM節點的數組。 這使得容易構建接收模板的組件，例如接受模板以定義其輸出行的網格組件。 有關完整的示例，未來章節講詳細介紹。

以下特殊變量也可在綁定中使用，但不是綁定上下文對象的一部分：

• $context

  這指的是當前綁定上下文對象。 如果要訪問上下文的屬性（如果它們也可能存在于視圖模型中），或者如果要將上下文對象傳遞到視圖模型中的輔助函數，則這可能很有用。

• $element

  這是元素DOM對象（對于虛擬元素，它將是注釋DOM對象）當前綁定。 如果綁定需要訪問當前元素的屬性，這可能很有用。 例：

  <div id="item1" data-bind="text: $element.id"></div>

控制或修改自定義綁定中的綁定上下文

就像使用foreach的內置綁定一樣，自定義綁定可以更改其后代元素的綁定上下文，或通過擴展綁定上下文對象來提供特殊屬性。 這將在創建控制后代綁定的自定義綁定章節中進行詳細描述。

章節結語

在以后章節中，將會介紹到KnockoutJS3.X的高級應用，盡請期待，感謝閱讀。支持的話請點一波關注和推薦。謝謝