zoukankan      html  css  js  c++  java
  • KnockoutJS 3.X API 第四章(14) 绑定语法细节

    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的高级应用,尽请期待,感谢阅读。支持的话请点一波关注和推荐。谢谢

  • 相关阅读:
    HDU1312 ZOJ2165 Red and Black
    HDU1312 ZOJ2165 Red and Black
    HDU1181 变形课【DFS】
    codevs1017 乘积最大
    codevs1220 数字三角形
    codevs1169 传纸条
    codevs1219 骑士游历
    codevs1010 过河卒
    codevs1166 矩阵取数游戏
    codevs1154 能量项链
  • 原文地址:https://www.cnblogs.com/smallprogram/p/5956631.html
Copyright © 2011-2022 走看看