Ember loading、error子路由
在前面的Ember.js 入门指南之二十路由定义提过loading
、error
子路由,它们是Ember默认创建的,并在beforeModel
、model
、afterModel
这三个回调执行完毕之前会先渲染当前路由的loading
和error
模板。
Router.map(function() {
this.route('posts', function() {
this.route('post', { path: '/:post_id'});
});
});
对于上述的路由设置Ember会生成如下的路由列表:
每个路由都会自动生成一个loading
、error
路由,下面我将一一演示这两个路由的作用。
图片前面loading
、error
路由对应的application
路由。posts_loading
和posts_error
对应的是posts
路由。
1,loading子状态
Ember建议数据放在beforeModel
、model
、afterModel
回调中获取并传递到模板显示。但是只要是加载数据就需要时间,对于Ember应用来说,在model
等回调中加载完数据才会渲染模板,如果加载数据比较慢那么用户看到的页面就是一个空白的页面,用户体验很差!
Ember提供的解决办法是:在beforeModel
、model
、afterModel
回调还没返回前先进入一个叫loading
的子状态,然后渲染一个叫routeName-loading
的模板(如果是application
路由则对应的直接是loading
、error
不需要前缀)。
为了演示这效果在app/templates
下创建一个posts-loading
模板。如果程序正常,在渲染模板posts
之前会先渲染这个模板。
<img src="assets/images/loading/loading.gif" />
然后修改路由posts.js
,让model
回调执行时间更长一些。
// app/routes/posts.js
import Ember from 'ember';
export default Ember.Route.extend({
model: function() {
// 模拟一个延时操作,
for (var i = 0; i < 10000000;i++) {
}
return Ember.$.getJSON('https://api.github.com/repos/emberjs/ember.js/pulls');
}
});
执行http://localhost:4200/posts,首先会看到执行的loading
模板的内容,然后才看到真正要显示的数据。有一个加载过程,如下面2幅图片所示。
2,loading事件
在beforeModel
、model
、afterModel
回调没有立即返回之前,会先执行一个名为loading的事件。
// app/routes/posts.js
import Ember from 'ember';
export default Ember.Route.extend({
model: function() {
// 模拟一个延时操作,
for (var i = 0; i < 10000000;i++) {
}
return Ember.$.getJSON('https://api.github.com/repos/emberjs/ember.js/pulls');
},
actions: {
loading: function(transition, originRoute) {
alert("Sorry this is taking so long to load!!");
}
}
});
页面刷新后会弹出一个提示框,先不点击“确定”。打开浏览器的“开发者 -> 开发者工具”,切换到Network标签下。找到“pulls”这个请求,点击它。
从图中可以看到此时model
回调并没有返回。此时响应的内容是空的,说明loading
事件实在model
回调返回之前执行了。
然后点击弹出框的“确定”,此时可以看到Response有数据了。说明model
回调已经执行完毕。
注意:如果当前的路由没有显示定义loading
事件,这个时间会冒泡到父路由,如果父路由也没有显示定义loading
事件,那么会继续向上冒泡,一直到最顶端的路由application
。
3,error子状态
与loading
子状态类似,error
子状态会在beforeModel
、model
、afterModel
回调执行过程中出现错误的时候触发。
命名方式与loading
子状态也是类似的。现在定义一个名为posts-error.hbs
的模板。
<p style="color: red;">
posts回调解析出错。。。。
</p>
然后在model
回调中手动添加一个错误代码。
// app/routes/posts.js
import Ember from 'ember';
export default Ember.Route.extend({
model: function() {
// 模拟一个延时操作,
for (var i = 0; i < 10000000;i++) {
}
var e = parseInt(value);
return Ember.$.getJSON('https://api.github.com/repos/emberjs/ember.js/pulls');
}
});
注意var e = parseInt(value);
这句代码,由于value
没有定义所以应该会报错。那么此时页面会显示什么呢??
如果你的演示程序没有其他问题那么你也会得到上图的结果。但是如果没有定义这个模板,那么界面上将是什么都不显示。
如果你想在xxx-error.hbs
模板上看到是什么错误信息,你可以在模板上打印model
的值。如下:
<p style="color: red;">
posts回调解析出错。。。。
<br>
{{model}}
</p>
此时页面会显示出你的代码是什么错误。
不过相比于浏览器控制台打印的错误信息简单很多!!!
4,error事件
error
事件与第一点讲的loading事件也是相似的。使用方式与loading
一样。个人觉得这个事件非常有用,我们可以在这个事件中根据error
状态码的不同执行不同的逻辑,比如跳转到不同的路由上。
// app/routes/posts.js
import Ember from 'ember';
export default Ember.Route.extend({
model: function() {
return Ember.$.getJSON('https://api.github.com/repos/emberjs/ember.js/pulls____');
},
actions: {
error: function(error, transition) {
console.log('error = ' + error.status);
// 打印error对象里的所有属性和方法名
for(var name in error){
console.log(name);
// console.log('属性值或者方法体==》' + error[name]);
}
alert(names);
if (error && error.status === 400) {
return this.transitionTo("about");
} else if (error.status === 404) {
return this.transitionTo("form");
} else {
console.log('else......');
}
}
}
});
注意getJSON
方法里的URL,我在URL后面随机加了一些字符,目的是让这个URL不存在。此时请求应该会找不到这个地址error
的响应码应该是404。然后直接跳转到form
这个路由上。
运行http://localhost:4200/posts之后,浏览器控制台打印信息如下:
页面也会跳转到form
。
到此路由加载数据过程中涉及的两个状态loading
和error
的内容全部介绍完,这两个状态在优化用户体验方面是非常有用的,希望想学习Ember的同学好好掌握!!!=^=
博文完整代码放在Github(博文经过多次修改,博文上的代码与github代码可能又出入,不过影响不大!),如果你觉得博文对你有点用,请在github项目上给我点个star
吧。您的肯定对我来说是最大的动力!!