Ember.js 入门指南——工具类的助手

本篇主要介绍格式转换、自定义helper、自定义helper参数、状态helper、HTML标签转义这几个方面的东西。

按照文章惯例先准备好测试所需要的数据、文件。仍然是使用Ember CLI命令,这次我们创建的是helper、controller、route(创建route会自动创建template)。

ember generate helper my-helper

ember generate controller tools-helper

ember generate route tools-helper

1,自定义helper

自定义助手非常简答直接使用Ember CLI命令生成就可以了。当然你也可以手动创建,自定义的助手都是放在app/helpers目录下。Ember会根据模板上使用的助手自动到这个目录查找。定义了helper之后你就可以直接在模板上使用。

<!--  //app/templates/tools-helper.hbs  -->
 
my-helper: {{my-helper}}

程序没有报错,但是什么也没有显示。是的什么也没有显示。没有显示就对了。因为我们对于刚刚创建的app/helpers/my-helper.js没有做任何的修改。你可以看这个文件的代码。直接返回了params,目前来说这个参数是空的。修改这个文件,直接返回一个字符串。

//  app/helpers/my-helper.js
 
import Ember from ‘ember‘;
 
export function myHelper(params/*, hash*/) {
  return "hello world!";
}
 
export default Ember.Helper.helper(myHelper);

此时可以在页面上看到直接打印了“hello world!”这个字符串。这就是一个最简单的自定义helper,不过这么简单helper显然是没啥用的。Ember的作者肯定不会这么傻的,接着下面介绍helper的参数。

注意:使用模板的名字跟文件名是一致的。不同单词使用“-”分隔,个命名规则不是制性的但是Ember建么做,Ember会自根据helper的名字找到对应的自定的helper,然后行helper里名字为myHelper(名字是文件名的驼峰式命名)的方法,在这个方法里你可以实现你需要的逻辑些工作Ember自帮你做了,不需要你写解析的代

1,helper无名参数

上面的代码定义了一个最简单的helper,不过没啥用,Ember允许在自定义的helper上添加自定义的参数。

<!--  //app/templates/tools-helper.hbs  -->
my-helper-param: {{my-helper ‘chen‘   ‘ubuntuvim‘}}

在这个自定义的helper中增加了两个参数,既然有了参数那么又有什么用呢?当然是有用的,你可以在自定义的helper中获取参数,获取模板的参数有两种方式。

写法一

//  app/helpers/my-helper.js
 
import Ember from ‘ember‘;
 
export function myHelper(params/*, hash*/) {
       // 获取模板上的参数
     var p1 = params[0];
     var p2 = params[1];
     console.log(‘p1 = ‘ + p1 + ", p2 = " + p2);
 
       return p1 + " " + p2;
}
 
export default Ember.Helper.helper(myHelper);

写法二

//  app/helpers/my-helper.js
 
import Ember from ‘ember‘;
 
export function myHelper([arg1, arg2]) {
       console.log(‘p1 = ‘ + arg1 + ", p2 = " + arg2);
       return arg1 + " " + arg2;
}
 
export default Ember.Helper.helper(myHelper);

参数很多的情况使用第一种方式用循环获取参数比较方便,参数少情况第二种方式更加简便,直接使用!

注意:参数的顺序与模板传入的顺序一致。

页面刷新之后可以在页面或者浏览器控制台看到在helper上设置的参数值了吧!!如果你的程序没有错误在浏览器上你也会得到下图的结果:

第一行因为在模板上没有传入参数所以是undefined,第二行传入了参数,并且直接从helper返回显示。

2,helper命名参数

上一点helper无名参数演示了在模板中传递无名的参数,这一小节讲为你介绍有名字的参数。

<!--  //app/templates/tools-helper.hbs  -->
my-helper-named-param: {{my-helper   firstName=‘chen‘ lastName=‘ubuntuvim‘}}

相比于第一种使用方式给每个参数增加了参数名。那么helper处理类有要怎么去获取这些参数呢?

//  app/helpers/my-helper.js
 
import Ember from ‘ember‘;
 
// 对于命名参数使用namedArgs获取
export function myHelper(params, namedArgs) {
       console.log(‘namedArgs = ‘ + namedArgs);
       console.log(‘params = ‘ + params);
       console.log(‘=========================‘);
       return namedArgs.firstName + ", " + namedArgs.lastName;
}
 
export default Ember.Helper.helper(myHelper);

获取命名参数使用namedArgs,其实你也可以按照前面的方法使用param获取参数值。你在第一行打印语句上打上断点,是浏览器进入debug模式,但不执行,你会发现params一开始是有值namedArgs没有值,但是执行到最后正好相反,params的值被置空了,namedArgs却有了模板设置的值,你可以猜想下,Ember可能是把params的值赋值到namedArgs上了,不同之处是namedArgs是以对象属性的方式取值并且不用关心参数的顺序问题,params是以数组的方式取值需要关心参数的顺序。

2,时间格式化

做开发的都应该遇到过数字或者时间格式问题,特别是时间格式问题应该是最普遍遇到的。不同的项目时间格式往往不同,有“yyyy-DD-mm”类型的有“yyyyMMdd”类型以及其他类型。

同样的Ember模板也给我们提供了类似的解决办法,那就是自定义格式化方法。通过自定义helper实现数据的格式化。

1,创建格式化helper:ember generate helper format-date

2,在controller初始化一个时间数据。

//  app/controllers/tools-helper.js
 
import Ember from ‘ember‘;
 
export default Ember.Controller.extend({
       currentDate: new Date()
});

默认情况下显示数据currentDate。

<!--    //app/templates/tools-helper.hbs    -->
{{ currentDate}}

此时显示的默认的数据格式。运行http://localhost:4200/tools-helper,可以在页面看到:Mon Sep 21 2015 23:46:03 GMT+0800 (CST) 这种格式的时间。显然不太合法我们的习惯,看着都觉得不舒服。那下面使用自定义的helper格式化日期格式。

//  app/helpers/format-data.js
 
import Ember from ‘ember‘;
 
/**
 * 注意:方法名字是文件名去掉中划线变大写,驼峰式写法
 * 或者你也可以直接作为helper的内部函数
 * @param  {[type]} params 从助手{{format-data}}传递过来的参数
 */
export function formatDate(params/*, hash*/) {
       console.log(‘params = ‘ + params);
    var d = Date.parse(params);
    var dd = new Date(parseInt(d)).toLocaleString().replace(/:\d{1,2}$/,‘ ‘);  //  2015/9/21 下午11:21
    var v = dd.replace("/", "-").replace("/", "-").substr(0, 9);
    return v;
}
 
export default Ember.Helper.helper(formatDate);

或者你也可以这样写。

export default Ember.Helper.helper(function formatDate(params/*, hash*/) {
    var d = Date.parse(params);
    var dd = new Date(parseInt(d)).toLocaleString().replace(/:\d{1,2}$/,‘ ‘);  //  2015/9/21 下午11:21
    var v = dd.replace("/", "-").replace("/", "-").substr(0, 9);
    return v;
});

为了简便,直接就替换字符,修改时间分隔字 “/”为“-”。

然后修改显示的模板,使用自定义的helper。

<!--    //app/templates/tools-helper.hbs    -->
{{format-date currentDate}}

此时页面上显示的时间是我们熟悉的时间格式:

上面介绍的是简答的用法,Ember还允许你传入时间的格式(format),以及本地化类型(locale)。

1,用命令新建一个helper:ember generate helper format-date-time

2,在controller类里新增两个用于测试的属性cDate和currentTime。

//  app/controllers/tools-helper.js
 
import Ember from ‘ember‘;
 
export default Ember.Controller.extend({
       currentDate: new Date(),
       cDate: ‘2015-09-22‘,
       currentTime: ‘00:22:32‘
});
<!--  //app/templates/tools-helper.hbs  -->
 
<br><br><br>
format-date-time: {{format-date-time currentDate cDate currentTime format="yyyy-MM-dd h:mm:ss"}}
 
 
<br><br><br>
format-date-time-local: {{format-date-time currentDate cDate currentTime format="yyyy-MM-dd h:mm:ss" locale="en"}}

在助手format-date-time上一共有4个属性。cDate和currentTime是从上下文获取值的变量,format和locale是Ember专门提供用于时间格式化的属性。

下面看看format-date-time这个助手怎么获取页面的数据。

// app/helpers/format-date-time.js
 
import Ember from ‘ember‘;
 
export function formatDateTime(params, hash) {
       //  参数的顺序跟模板{{format-date-time currentDate cDate currentTime}}上使用顺序一致,
       //  cDate比currentTime先,所以第一个参数是cDate
       console.log(‘params[0] = ‘ + params[0]);  //第一个参数是cDate,
       console.log(‘params[1] = ‘ + params[1]);  //  第二个是currentTime
       console.log(‘hash.format = ‘ + hash.format);
       console.log(‘hash.locale = ‘ + hash.locale);
       console.log(‘------------------------------------‘);
 
     return params;
}
 
export default Ember.Helper.helper(formatDateTime);

我只是演示怎么获取页面format-date-time助手设置的值,得到页面设置的值你想干嘛就干嘛……

最后看看浏览器控制台的输出信息。

因为页面使用了两次这个助手,所以自然也就打印了两次。

3,转义HTML标签

官方的解释是:为了保护你的应用免受跨点脚本攻击(XSS),Ember会自动把helper返回值中的HTML标签转义。

新建一个helper:ember generate helper escape-helper

// app/helpers/escape-helper.js
 
import Ember from ‘ember‘;
 
export function escapeHelper(params/*, hash*/) {
  // return Ember.String.htmlSafe(`<b>${params}</b>`);
  return `<b>${params}</b>`;
}
 
export default Ember.Helper.helper(escapeHelper);
<!--  //app/templates/tools-helper.hbs  -->
escape-helper: {{escape-helper   "helloworld!"}}

此时页面上会直接显示“<b>helloworld!</b>”而不是helloworld被加粗了!如果你确定你返回的字符串是安全的你可用使用htmlSafe方法,这个方法不会把HTML代码转义,HTML代码仍然能起作用,那么页面显示的将是加粗的“helloworld”。

到此模板这一章全部讲完了!!!但愿你能从中得到一点收获!!后面的文章将开始讲route,route在link-to助手这一篇已经讲过一点,但不是很详细。接下来的一章将会为你详细解释route。

时间: 2024-08-06 03:40:58

Ember.js 入门指南——工具类的助手的相关文章

Ember.js 入门指南——总目录

Ember.js 是什么?我想对于想学习它的人应该知道它是个什么东西,如果你想了解那就赶紧去 Google 或者百度,本系列教程是通过学习官网教程然后摘抄个人觉得比较重要的部分,加上学习实例整合而成,如有疏漏欢迎提出修改意见,一起成长! Ember官网:http://emberjs.com/ 教程官网:http://guides.emberjs.com/v2.0.0/ 在此简单介绍下 Ember: Ember是一个雄心勃勃的Web应用程序,消除了样板,并提供了一个标准的应用程序架构的JavaSc

Ember.js 入门指南——属性传递

1,传递参数到组件上 每个组件都是相对独立的,因此任何组件所需的数据都需要通过组件的属性把数据传递到组件中. 比如上篇<Ember.js 入门指南--组件定义>的第三点"{{component item.pn post=item}}"就是通过属性post把数据传递到组件foo-component或者bar-component上.如果在index.hbs中是如下方式调用组件那么渲染之后的页面是空的. {{component item.pn}} 请读者自己修改index.hbs

Ember.js 入门指南——控制器(controller)

ember new chapter5_controllers cd chapter5_controllers ember server 从本篇开始进入第五章控制器,controller在Ember2.0开始越来越精简了,职责也更加单一--处理逻辑. 下面是准备工作. 从新创建一个Ember项目,仍旧使用的是Ember CLI命令创建. 在浏览器执行项目,看到如下信息说明项目搭建成功. Welcome to Ember 1,控制器简介 控制器与组件非常相似,由此,在未来的新版本中很有可能组件将会完

Ember.js 入门指南——路由简介

从本文开始,将为大家介绍路由(route),如果你看过前面的<Ember.js 入门指南--{{link-to}} 助手>这篇文章应该初步了解了route.不过在这篇文章中只是简单介绍了路由是定义.路由层次,更深入的route将从本文开始逐一介绍. 当用户使用你的应用时,应用要在不同的状态之间切换.Ember提供了很多工具用于管理那些因应用规模改变而改变的状态. 讲route前先了解URL,在应用中大概会会有如下方式设置URL: 用户第一次加载应用的时: 用户手动改变URL,比如点击按钮之后跳

Ember.js 入门指南——路由定义

当你的应用启动的时候,路由器就会匹配当前的URL到你定义的路由上.然后按照定义的路由层次逐个加载数据.设置应用程序状态.渲染路由对应的模板. 1,基本路由 在app/router.js的map方法里定义的路由会映射到当前的URL.当map方法被调用的时候方法体内的route方法就会创建路由. 下面使用Ember CLI命令创建两个路由: ember generate route about ember generate route favorites 命令执行完之后你可在你的项目目录app/ro

Ember.js 入门指南——包裹内容

准备工作: ember g route wrapping-content-in-component-route        ember g component wrapping-content-in-component 有些情况下,你需要定义一个包裹其他模板提供的数据的组件.比如下面的例子: <!--  app/templates/components/wrapping-content-in-component.hbs  -->   <h1>{{title}}</h1>

Ember.js 入门指南——model简介2

本文接上一篇<Ember.js 入门指南--model简介1>. 2,核心概念 声明:下面简介内摘抄至http://www.emberjs.cn/guides/models/#toc_. 1,store store是应用存放记录的中心仓库.你可以认为store是应用的所有数据的缓存.应用的控制器和路由都可以访问这个共享的store:当它们需要显示或者修改一个记录时,首先就需要访问store. DS.Store的实例会被自动创建,并且该实例被应用中所有的对象所共享. store可以看做是一个缓存

Ember.js 入门指南--目录

本系列文章全部从(http://ibeginner.sinaapp.com/)迁移过来,欢迎访问原网站. Ember.js 是什么?我想对于想学习它的人应该知道它是个什么东西,如果你想了解那就赶紧去 Google 或者百度,本系列教程是通过学习官网教程然后摘抄个人觉得比较重要的部分,加上学习实例整合而成,如有疏漏欢迎提出修改意见,一起成长! Ember官网:http://emberjs.com/ 教程官网:http://guides.emberjs.com/v2.0.0/ 在此简单介绍下 Emb

Ember.js 入门指南——异步路由

本文将为你介绍路由的高级特性,这些高级特性可以用于处理项目复杂的异步逻辑. 关于单词promises,直译是承诺,但是个人觉得还是使用原文吧.读起来顺畅点. 1,promises(承诺) Ember的路由处理异步逻辑的方式是使用promises.简而言之,promises就是一个表示最终结果的对象.这个对象可能是fulfill(成功获取最终结果)也可能是reject(获取结果失败).为了获取这个最终值,或者是处理promises失败的情况都可以使用then方法,这个方法接受两个可选的回调方法,一