knockoutjs data-bind 声明式绑定整理

一、Visible绑定

1.功能

  Visible绑定通过绑定一个值来确定DOM元素显示或隐藏

2.示例

<div data-bind="visible: shouldShowMessage">
 You will see this message only when "shouldShowMessage" holds a true value.
</div>
<script type="text/javascript">
    var viewModel = {
        shouldShowMessage: ko.observable(true) // Message initially visible
    };
    viewModel.shouldShowMessage(false); // ... now it‘s hidden
    viewModel.shouldShowMessage(true); // ... now it‘s visible again
</script> 

3.说明

  当参数设置为一个假值(例如bool型值false、整型值0、null或者undefined)时,该绑定会设置yourElement.style.display为none,让元素隐藏。它的优先级高于任何你在CSS中定义的隐藏样式。

  当参数设置为一个真值(例如bool型值true、不等于null、Object对象或数组)时,该绑定会去掉yourElement.style.display值,让元素显示。

  

  注意,任何你在CSS中定义的样式会立即应用生效。

  如果参数是一个observable值,visible绑定使得元素的visible状态随着参数值的变化而变化。如果参数不是observable值,visible绑定仅仅会设置元素visible状态一次,以后不会再更新。

  注意:你可以选择使用JavaScript函数或者表达式作为参数值。这样的话,KO将会运行你的函数或者表达式,返回的结果来控制元素显示或者隐藏。

二、Text绑定

1.功能

  Text绑定主要是让DOM元素显示参数值。

  通常情况下,该绑定在<span>和<em>这样的元素上非常有用,而实际上你可以绑定任何元素。

2.示例

Today‘s message is: <span data-bind="text: myMessage"></span>
<script type="text/javascript">
 var viewModel = {
  myMessage: ko.observable() // Initially blank
  };
viewModel.myMessage("Hello, world!"); // Text appears
</script> 

3.说明

  Knockout将参数值设置为元素内容。元素之前的内容将会被覆盖。

  如果参数是一个observable值,text绑定将会在值变化时更新元素text内容。如果参数不是observable值,text绑定仅仅会设置元素内容一次,以后不会再更新。

  如果你传入的不是一个值或者一个字符串(比如:你传入一个对象或者数组)那么显示的文本将是yourParameter.toString()的结果。

三、html绑定

1.功能

  html绑定到DOM元素上,使得该元素显示的HTML值为你绑定的参数。如果在你的view model里声明HTML标记并且render的话,那非常有用。

2.示例

<div data-bind="html: details"></div>
<script type="text/javascript">
var viewModel = {
details: ko.observable() // Initially blank
};
viewModel.details("<em>For further details,
view the report <a href=‘report.html‘>here</a>.</em>"); // HTML content appears
</script>  

3.说明

  KO设置该参数值到元素的innerHTML属性上,元素之前的内容将被覆盖。

  如果参数是监控属性observable的,那元素的内容将根据参数值的变化而更新,如果不是,那元素的内容将只设置一次并且以后不在更新。

  如果你传的是不是数字或者字符串(例如一个对象或者数组),那显示的文本将是yourParameter.toString()的等价内容。

  注意:因为该绑定设置元素的innerHTML,你应该注意不要使用不安全的HTML代码,因为有可能引起脚本注入攻击。如果你不确信是否安全(比如显示用户输入的内容),那你应该使用text绑定,因为这个绑定只是设置元素的text 值innerText和textContent。

四、CSS类名绑定

1.功能

  css绑定是添加或删除一个或多个CSS class到DOM元素上。 非常有用,比如当数字变成负数时高亮显示。(注:如果你不想应用CSS class而是想引用style属性的话,请参考style绑定。)

2.示例

<div data-bind="css: { profitWarning: currentProfit() < 0 }">
  Profit Information
</div>
<script type="text/javascript">
var viewModel = {
        currentProfit: ko.observable(150000)
        // Positive value, so initially we don‘t apply the "profitWarning" class
};
viewModel.currentProfit(-50);
// Causes the "profitWarning" class to be applied
</script>

  效果就是当currentProfit 小于0的时候,添加profitWarning CSS class到元素上,如果大于0则删除这个CSS class。

view会随着监控属性的变化自动添加或者删除元素上的CSS class。

3.说明 

  该参数是一个JavaScript对象,属性是你的CSS class名称,值是比较用的true或false,用来决定是否应该使用这个CSS class。

  你可以一次设置多个CSS class。例如,如果你的view model有一个叫isServre的属性,

<div data-bind="css: { profitWarning: currentProfit() < 0, majorHighlight: isSevere }">

五、Style属性绑定

1.功能

  style绑定是添加或删除一个或多个DOM元素上的style值。比如当数字变成负数时高亮显示,或者根据数字显示对应宽度的Bar。(注:如果你不是应用style值而是应用CSS class的话,请参考CSS绑定。)

2.示例

<div data-bind="style: { color: currentProfit() < 0 ? ‘red‘ : ‘black‘ }">
Profit Information
</div>
<script type="text/javascript">
var viewModel = {
        currentProfit: ko.observable(150000)
 // Positive value, so initially black
   };
    viewModel.currentProfit(-50);
// Causes the DIV‘s contents to go red</script>

  当currentProfit 小于0的时候div的style.color是红色,大于的话是黑色。

  view会随着监控属性的变化自动添加或者删除该元素的style值

3.说明

  该参数是一个JavaScript对象,属性是你的style的名称,值是该style需要应用的值。

  你可以一次设置多个style值。例如,如果你的view model有一个叫isServre的属性,

<div data-bind="style: { color: currentProfit() < 0 ? ‘red‘ : ‘black‘, fontWeight: isSevere() ? ‘bold‘ : ‘‘ }">
...
</div>

  如果参数是监控属性observable的,那随着值的变化将会自动添加或者删除该元素上的style值。如果不是,那style值将会只应用一次并且以后不在更新。

  你可以使用任何JavaScript表达式或函数作为参数。KO将用它的执行结果来决定是否应用或删除style值。

六、attr属性绑定

1.功能

  这个绑定可以用于给DOM元素添加自定义属性,或绑定到已有的属性:

  attr 绑定提供了一种方式可以设置DOM元素的任何属性值。你可以设置img的src属性,连接的href属性。使用绑定,当模型属性改变的时候,它会自动更新。

2.示例

<a data-bind="attr: { href: url, title: details }">
    Report
</a>
<script type="text/javascript">
var viewModel = {
        url: ko.observable("year-end.html"),
        details: ko.observable("Report including final year-end statistics")
    };
</script>

  呈现结果是该连接的href属性被设置为year-end.html, title属性被设置为Report including final year-end statistics。

3.说明

  该参数是一个JavaScript对象,属性是你的attribute名称,值是该attribute需要应用的值。

  如果参数是监控属性observable的,那随着值的变化将会自动添加或者删除该元素上的attribute值。如果不是,那attribute值将会只应用一次并且以后不在更新。

  

  注意:应用的属性名字不是合法的JavaScript变量命名

  如果你要用的属性名称是data-something的话,你不能这样写:

<div data-bind="attr: { data-something: someValue }">...</div>

  因为data-something 不是一个合法的命名。解决方案是:在data-something两边加引号作为一个字符串使用。这是一个合法的JavaScript 对象 文字(从JSON技术规格说明来说,你任何时候都应该这样使用,虽然不是必须的)。例如,

<div data-bind="attr: { ‘data-something’: someValue }">...</div>

七、foreach绑定

1.功能

  使用此功能可以方便我们循环遍历输出某个数组、集合中的内容。

2.示例

(1)、循环遍历输出数组

<script type="text/javascript" src="knockout-2.2.0.js"></script>

 <table>
     <thead>
         <tr><th>First name</th><th>Last name</th></tr>
     </thead>
     <tbody data-bind="foreach: people">
         <tr>
             <td data-bind="text: firstName"></td>
             <td data-bind="text: lastName"></td>
         </tr>
     </tbody>
 </table> 

 <script type="text/javascript">
     ko.applyBindings({
         people: [
             { firstName: ‘Bert‘, lastName: ‘Bertington‘ },
             { firstName: ‘Charles‘, lastName: ‘Charlesforth‘ },
             { firstName: ‘Denise‘, lastName: ‘Dentiste‘ }
         ]
     });
 </script>

(2)、动态增加和删除遍历节点

<script type="text/javascript" src="knockout-2.2.0.js"></script>

 <h4>People</h4>
 <ul data-bind="foreach: people">
     <li>
         Name at position <span data-bind="text: $index"> </span>:
         <span data-bind="text: name"> </span>
         <a href="#" data-bind="click: $parent.removePerson">Remove</a>
     </li>
 </ul>
 <button data-bind="click: addPerson">Add</button>

 <script type="text/javascript">
     function AppViewModel() {
         var self = this;

         self.people = ko.observableArray([
         { name: ‘Bert‘ },
         { name: ‘Charles‘ },
         { name: ‘Denise‘ }
     ]);

         self.addPerson = function () {
             self.people.push({ name: "New at " + new Date() });
         };

         self.removePerson = function () {
             self.people.remove(this);
         }
     }

     ko.applyBindings(new AppViewModel());
 </script>

(3)、如果我们想要输出数组中的所有元素而不是像例一中使用firstName去指定元素的话,我们可以使用$data来进行输出。比如:

<script type="text/javascript" src="knockout-2.2.0.js"></script>

 <ul data-bind="foreach: months">
     <li>
         The current item is: <b data-bind="text: $data"></b>
     </li>
 </ul> 

 <script type="text/javascript">
     ko.applyBindings({
         months: [‘Jan‘, ‘Feb‘, ‘Mar‘, ‘etc‘]
     });
 </script>

  当然,我们也可以使用$data来调用数组中具体的元素,比如我们要使用$data调用例1中的firstName的话,我们可以使用$data.firstName来输出firstName。

(4)、使用$index、$parent等其他的上下文属性

  我们曾在例2中使用了$index来表示我们数组的下标,$index是Knockoutjs为我们提供的属性,我们可以直接引用,它会随着数组等下标的变化动态变化的,比如如果数组的长度减少了1,$index的值也会跟着减少的。

  我们也可以使用$parent来使用foreach元素之外的属性,比如:

<h1 data-bind="text: blogPostTitle"></h1>
<ul data-bind="foreach: likes">
    <li>
        <b data-bind="text: name"></b> likes the blog post <b data-bind="text: $parent.blogPostTitle"></b>
    </li>
</ul>

  这里使用$parent来调用foreach循环体之外的blogPostTitle属性。

(5)、使用"as"为foreach中的元素定义别名

  我们可以使用$data来代替数组中的元素,同时我们也可以使用as来为我们要遍历的元素起一个别名。

<script type="text/javascript" src="knockout-2.2.0.js"></script>

 <ul data-bind="foreach: { data: categories, as: ‘category‘ }">
     <li>
         <ul data-bind="foreach: { data: items, as: ‘item‘ }">
             <li>
                 <span data-bind="text: category.name"></span>:
                 <span data-bind="text: item"></span>
             </li>
         </ul>
     </li>
 </ul> 

 <script>
     var viewModel = {
         categories: ko.observableArray([
             { name: ‘Fruit‘, items: [‘Apple‘, ‘Orange‘, ‘Banana‘] },
             { name: ‘Vegetables‘, items: [‘Celery‘, ‘Corn‘, ‘Spinach‘] }
         ])
     };
     ko.applyBindings(viewModel);
 </script>

  在使用的时候我们要注意,起别名使用的是as:‘category‘而不是as:category。

(6)、在没有绑定属性的情况下使用foreach

  有的时候我们想要循环输出一些特殊的内容,比如我们想要输入下面文本中的<li></li>标签:

<ul>
     <li class="header">Header item</li>
     <!-- The following are generated dynamically from an array -->
     <li>Item A</li>
     <li>Item B</li>
     <li>Item C</li>
 </ul>

  如果我们想要循环输出上面代码中的<li></li>标签的话,我们就没有一个可以绑定foreach的元素,此时我们可以通过以下的代码来实现:

<script type="text/javascript" src="knockout-2.2.0.js"></script>

 <ul>
     <li class="header">Header item</li>
     <!-- ko foreach: myItems -->
         <li>Item <span data-bind="text: $data"></span></li>
     <!-- /ko -->
 </ul> 

 <script type="text/javascript">
     ko.applyBindings({
         myItems: [‘A‘, ‘B‘, ‘C‘]
     });
 </script>

  我们使用<!--ko--><!--/ko-->来表示循环的开始和结束,这是一个虚拟的标签,Knockoutjs能够对其中的foreach进行绑定就好像你将foreach绑定到了一个真实的标签上一样。

(7)、默认不显示被标示为删除的元素

  有的时候我们要跳过数组中的一些元素,此时这些元素已经被标示为删除,但并没有被真实删除,这些元素当我们使用foreach输出的时候是默认不显示的,如果我们想要这些元素显示的话,我们可以使用includeDestroyed这个选项,比如:

<div data-bind=‘foreach: { data: myArray, includeDestroyed: true }‘>
    ...
</div>

八、click绑定

1.功能

  click绑定在DOM元素上添加事件句柄以便元素被点击的时候执行定义的JavaScript 函数。大部分是用在button,input和连接a上,但是可以在任意元素上使用。

2.示例

<div>
    You‘ve clicked
    <span data-bind="text: numberOfClicks">
    </span>
    times
    <button data-bind="click: incrementClickCounter">
        Click me
    </button>
</div>
<script type="text/javascript">
    var viewModel = {
        numberOfClicks: ko.observable(0),
        incrementClickCounter: function() {
            var previousCount = this.numberOfClicks();
            this.numberOfClicks(previousCount + 1);
        }
    };
</script>

3.说明

  Click点击事件时所执行的函数。

  你可以声明任何JavaScript函数 – 不一定非要是view model里的函数。你可以声明任意对象上的任何函数,例如:someObject.someFunction。

  View model上的函数在用的时候有一点点特殊,就是不需要引用对象的,直接引用函数本身就行了,比如直接写incrementClickCounter就可以了,而无需写成:viewModel.incrementClickCounter(尽管是合法的)。

  ps:每次点击按钮的时候,都会调用incrementClickCounter()函数,然后更新自动更新点击次数。

九、value 绑定

1.功能

  value绑定是关联DOM元素的值到view model的属性上。主要是用在表单控件<input>,<select>和<textarea>上。

  当用户编辑表单控件的时候, view model对应的属性值会自动更新。同样,当你更新view model属性的时候,相对应的元素值在页面上也会自动更新。

  注:如果你在checkbox或者radio button上使用checked绑定来读取或者写入元素的 checked状态,而不是value 值的绑定。

2.示例

<p>
    Login name:
    <input data-bind="value: userName" />
</p>
<p>
    Password:
    <input type="password" data-bind="value: userPassword" />
</p>
<script type="text/javascript">
    var viewModel = {
        userName: ko.observable(""),
        // Initially blank        userPassword: ko.observable("abc"), // Prepopulate    };

</script>

3.说明

  KO设置此参数为元素的value值。之前的值将被覆盖。

  如果参数是监控属性observable的,那元素的value值将根据参数值的变化而更新,如果不是,那元素的value值将只设置一次并且以后不在更新。

  如果你提供的参数不是一个数字或者字符串(而是对象或者数组)的话,那显示的value值就是yourParameter.toString() 的内容(通常没用,所以最好都设置为数字或者字符串)。

  不管什么时候,只要你更新了元素的值,那 KO都会将view model对应的属性值自动更新。默认情况下当用户离开焦点(例如onchange事件)的时候,KO才更新这个值,但是你可以通过第2个参数valueUpdate来特别指定改变值的时机。

4.其他

valueUpdate

  如果你使用valueUpdate参数,那就是意味着KO将使用自定义的事件而不是默认的离开焦点事件。下面是一些最常用的选项:

  “change”(默认值) - 当失去焦点的时候更新view model的值,或者是<select> 元素被选择的时候。

  “keyup” – 当用户敲完一个字符以后立即更新view model。

  “keypress” – 当用户正在敲一个字符但没有释放键盘的时候就立即更新view model。不像 keyup,这个更新和keydown是一样的。

  “afterkeydown” – 当用户开始输入字符的时候就更新view model。主要是捕获浏览器的keydown事件或异步handle事件。

  上述这些选项,如果你想让你的view model进行实时更新,使用“afterkeydown”是最好的选择。

示例:

<p>
    Your value:
    <input data-bind="value: someValue, valueUpdate: ‘afterkeydown‘" />
</p>
<p>
    You have typed:
    <span data-bind="text: someValue">
    </span>
</p>
<!-- updates in real-time -->
<script type="text/javascript">
    var viewModel = {
        someValue: ko.observable("edit me")
    };
</script>

十、event绑定

1.功能

  event绑定在DOM元素上添加指定的事件句柄以便元素被触发的时候执行定义的JavaScript 函数。大部分情况下是用在keypress,mouseover和mouseout上。

2.示例

<div>
    <div data-bind="event: { mouseover: enableDetails, mouseout: disableDetails }">
        Mouse over me
    </div>
    <div data-bind="visible: detailsEnabled">
        Details
    </div>
</div>
<script type="text/javascript">
    var viewModel = {
        detailsEnabled: ko.observable(false),
        enableDetails: function() {
            this.detailsEnabled(true);
        },
        disableDetails: function() {
            this.detailsEnabled(false);
        }
    };
</script>

3.说明

  你需要传入的是一个JavaScript对象,他的属性名是事件名称,值是你所需要执行的函数。

  你可以声明任何JavaScript函数 – 不一定非要是view model里的函数。你可以声明任意对象上的任何函数,例如:event: { mouseover: someObject.someFunction }。

  View model上的函数在用的时候有一点点特殊,就是不需要引用对象的,直接引用函数本身就行了,比如直接写event: { mouseover: enableDetails }就可以了,而无需写成:event: { mouseover: viewModel.enableDetails }(尽管是合法的)。

  ps:每次鼠标在第一个元素上移入移出的时候都会调用view model上的方法来toggle detailsEnabled的值,而第二个元素会根据detailsEnabled的值自动显示或者隐藏。

参考资料:http://www.aizhengli.com/knockoutjs/knockoutjs.html

时间: 2024-10-12 16:44:18

knockoutjs data-bind 声明式绑定整理的相关文章

【Knockout】三、data-bind声明式绑定

1.visible绑定 <div id="myview" data-bind="visible : isVisible"> visible bind </div> <script> var viewModel = { isVisible : ko.observable(true) }; viewModel.isVisible(false); var el = document.getElementById('myview'); k

spring 声明式事务原理解读

在Spring中,声明式事务是通过事务属性(transaction attribute)来定义的.事务属性描述了事务策略如何应用到方法上.事务属性包含5个方面: 传播行为 隔离级别 是否只读 事务超时 回滚规则 尽管Spring提供了多种声明式事务的机制,但是所有的方式都依赖这五个参数来控制如何管理事务策略. (上述内容参考<Spring In Action>第三版). 对于声明式事务是使用Spring提供的tx配置命名空间.其中一些声明式事务配置元素依赖于部分Spring的AOP配置元素.

SpringMVC+Spring+Mybatis整合,使用druid连接池,声明式事务,maven配置

一直对springmvc和mybatis挺怀念的,最近想自己再搭建下框架,然后写点什么. 暂时没有整合缓存,druid也没有做ip地址的过滤.Spring的AOP简单配置了下,也还没具体弄,不知道能不能用,log也不知道能不能用,`(*∩_∩*)′哈哈,有点不负责任...... 直接上代码: 使用的eclipse和eclipse自带的maven,参考了网上的资料,有些代码是拷贝的,不过都自己测试过了.嗯,可以跑起来... 先上项目结构: 新建maven项目,选择web,然后配置pom: <pro

Spring Cloud 声明式服务调用 Feign

一.简介 在上一篇中,我们介绍注册中心Eureka,但是没有服务注册和服务调用,服务注册和服务调用本来应该在上一章就应该给出例子的,但是我觉得还是和Feign一起讲比较好,因为在实际项目中,都是使用声明式调用服务.而不会在客服端和服务端存储2份相同的model和api定义.Feign在RestTemplate的基础上对其封装,由它来帮助我们定义和实现依赖服务接口的定义.Spring Cloud Feign 基于Netflix Feign 实现的,整理Spring Cloud Ribbon 与 S

【第三章】声明式服务调用(Feign)

当我们通过RestTemplate调用其它服务的API时,所需要的参数须在请求的URL中进行拼接,如果参数少的话或许我们还可以忍受,一旦有多个参数的话,这时拼接请求字符串就会效率低下,并且显得好傻.那么有没有更好的解决方案呢?答案是确定的有,Netflix已经为我们提供了一个框架:Feign. Feign是一个声明式的Web Service客户端,它的目的就是让Web Service调用更加简单.Feign提供了HTTP请求的模板,通过编写简单的接口和插入注解,就可以定义好HTTP请求的参数.格

Spring Cloud 入门Eureka -Consumer服务消费(声明式Feign)(三)

Spring Cloud Feign是一套基于Netflix Feign实现的声明式服务调用客户端.它使得编写Web服务客户端变得更加简单.我们只需要通过创建接口并用注解来配置它既可完成对Web服务接口的绑定.它具备可插拔的注解支持,包括Feign注解.JAX-RS注解.它也支持可插拔的编码器和解码器.Spring Cloud Feign还扩展了对Spring MVC注解的支持,同时还整合了Ribbon和Eureka来提供均衡负载的HTTP客户端实现. 1.pom.xml,这里有所不同depen

Rabbitmq与spring整合之重要组件介绍——AMQP声明式配置&amp;RabbitTemplate组件

上一节是使用rabbitAdmin的管理组件进行声明队列,交换器,绑定等操作,本节则是采用AMQP声明式配置来声明这些东西.AMQP声明主要是通过@Bean注解进行的. 配置: 1 package com.zxy.demo.config; 2 3 import org.springframework.amqp.core.Binding; 4 import org.springframework.amqp.core.BindingBuilder; 5 import org.springframew

通过 React Hooks 声明式地使用 setInterval

本文由云+社区发表 作者:Dan Abramov 接触 React Hooks 一定时间的你,也许会碰到一个神奇的问题: setInterval 用起来没你想的简单. Ryan Florence 在他的推文里面说到: 不少朋友跟我提起,setInterval 和 hooks 一起用的时候,有种蛋蛋的忧伤. 老实说,这些朋友也不是胡扯.刚开始接触 Hooks 的时候,确实还挺让人疑惑的. 但我认为谈不上 Hooks 的毛病,而是 React 编程模型和 setInterval 之间的一种模式差异.

Spring Cloud Eureka 分布式开发之服务注册中心、负载均衡、声明式服务调用实现

介绍 本示例主要介绍 Spring Cloud 系列中的 Eureka,使你能快速上手负载均衡.声明式服务.服务注册中心等 Eureka Server Eureka 是 Netflix 的子模块,它是一个基于 REST 的服务,用于定位服务,以实现云端中间层服务发现和故障转移. 服务注册和发现对于微服务架构而言,是非常重要的.有了服务发现和注册,只需要使用服务的标识符就可以访问到服务,而不需要修改服务调用的配置文件.该功能类似于 Dubbo 的注册中心,比如 Zookeeper. Eureka